Method: projects.locations.userEvents.collect

Écrit un seul événement utilisateur à partir du navigateur. Cette méthode utilise une requête GET en raison de la restriction du navigateur concernant l'envoi de données POST à un domaine tiers.

Cette méthode n'est utilisée que par le pixel JavaScript de l'API Discovery Engine et Google Tag Manager. Les utilisateurs ne doivent pas appeler cette méthode directement.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de la ressource parente. Si l'action de collecte d'événements utilisateur est appliquée au niveau DataStore, le format est le suivant : projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}. Si l'action de collecte d'événements utilisateur est appliquée au niveau Location, par exemple, l'événement avec Document sur plusieurs DataStore, le format est le suivant : projects/{project}/locations/{location}.

Paramètres de requête

Paramètres
userEvent

string

Obligatoire. URL encodée du fichier proto UserEvent, avec une limite de longueur de 2 000 000 de caractères.
uri

string

URL incluant les paramètres CGI, mais excluant le fragment de hachage, avec une limite de 5 000 caractères. Cette information est souvent plus utile que l'URL de provenance, car de nombreux navigateurs n'envoient que le domaine pour les requêtes tierces.
ets

string (int64 format)

Horodatage de l'événement en millisecondes. Cela empêche la mise en cache par le navigateur des requêtes GET identiques. Le nom est abrégé pour réduire le nombre d'octets de la charge utile.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, la réponse est une réponse HTTP générique dont le format est défini par la méthode.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour plus d'informations, consultez la Authentication Overview.