Method: projects.locations.userEvents.collect

Escribe un solo evento de usuario desde el navegador. Esto usa una solicitud GET debido a la restricción del navegador de POST-ing a un dominio de terceros.

Este método solo lo usan el píxel de JavaScript de la API de Discovery Engine y Google Tag Manager. Los usuarios no deben llamar a este método directamente.

Solicitud HTTP

GET https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/userEvents:collect

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el nombre del recurso superior. Si la acción de recopilación de eventos de usuario se aplica en el nivel DataStore, el formato es el siguiente: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}. Si la acción de recopilación de eventos de usuario se aplica en el nivel Location, por ejemplo, el evento con Document en varios DataStore, el formato es el siguiente: projects/{project}/locations/{location}.

Parámetros de consulta

Parámetros
userEvent

string

Obligatorio. Es el proto de UserEvent codificado en URL con un límite de longitud de 2,000,000 caracteres.
uri

string

Es la URL, incluidos los parámetros cgi, pero sin incluir el fragmento hash con un límite de longitud de 5,000 caracteres. Esto suele ser más útil que la URL de referencia, ya que muchos navegadores solo envían el dominio para solicitudes de terceros.
ets

string (int64 format)

Es la marca de tiempo del evento en milisegundos. Esto evita el almacenamiento en caché del navegador de solicitudes get idénticas. El nombre se abrevia para reducir los bytes de carga útil.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, la respuesta es una respuesta HTTP genérica, y el método define su formato.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Para obtener más información, consulta Authentication Overview.