Method: projects.locations.userEvents.collect

Escribe un solo evento del usuario desde el navegador. Esto usa una solicitud GET debido a la restricción del navegador de enviar solicitudes POST 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 de acceso

Parámetros
parent

string

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

Parámetros de consulta

Parámetros
userEvent

string

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

string

Es la URL que incluye parámetros CGI, pero excluye el fragmento hash, con un límite de 5,000 caracteres. A menudo, esto es más útil que la URL de referencia, ya que muchos navegadores solo envían el dominio para las solicitudes de terceros.
ets

string (int64 format)

Es la marca de tiempo del evento en milisegundos. Esto evita que el navegador almacene en caché las solicitudes GET que, de otro modo, serían idénticas. El nombre se abrevia para reducir los bytes de la 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.readwrite
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite

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