Method: projects.locations.dataStores.userEvents.collect

Écrit un seul événement utilisateur à partir du navigateur. Cette opération utilise une requête GET en raison de la restriction du navigateur concernant l'envoi de requêtes 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/*/dataStores/*}/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 parent. 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 dans plusieurs DataStore), le format est le suivant : projects/{project}/locations/{location}.

Paramètres de requête

Paramètres
userEvent

string

Obligatoire. Proto UserEvent encodé en URL, limité à 2 000 000 de caractères.
uri

string

URL incluant les paramètres CGI, mais excluant le fragment de hachage, limitée à 5 000 caractères. Cette URL 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 utiles.

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 niveaux d'accès OAuth suivants :

  • 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

Pour plus d'informations, consultez la Authentication Overview.