Method: projects.locations.userEvents.collect

Escribe un solo evento de usuario desde el navegador. Se 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 Discovery Engine y Google Tag Manager. Los usuarios no deben invocar este método directamente.

Solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
parent

string

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

Los parámetros de consulta

Parámetros
userEvent

string

Obligatorio. UserEvent proto codificado en URL con un límite de longitud de 2.000.000 caracteres.
uri

string

La URL, incluidos los parámetros cgi, pero excluido el fragmento hash, con un límite de 5000 caracteres. A menudo, esta información es más útil que la URL referente, ya que muchos navegadores solo envían el dominio de las solicitudes de terceros.
ets

string (int64 format)

Marca de tiempo del evento en milisegundos. De esta forma, se evita que el navegador almacene en caché 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 la solicitud se realiza correctamente, la respuesta es una respuesta HTTP genérica cuyo formato se define mediante el método.

Permisos de autorización

Debes disponer de 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 el Authentication Overview.