Method: projects.locations.userEvents.collect

Grava um único evento do usuário no navegador. Isso usa uma solicitação GET devido à restrição do navegador de POST em um domínio de terceiros.

Esse método é usado apenas pelo pixel JavaScript da API Discovery Engine e pelo Gerenciador de tags do Google. Os usuários não devem chamar esse método diretamente.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso pai. Se a ação de coleta de eventos do usuário for aplicada no nível DataStore, o formato será: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}. Se a ação de coleta de eventos do usuário for aplicada no nível Location, por exemplo, o evento com Document em vários DataStore, o formato será: projects/{project}/locations/{location}.

Parâmetros de consulta

Parâmetros
userEvent

string

Obrigatório. Proto UserEvent codificado por URL com um limite de 2.000.000 caracteres.
uri

string

O URL, incluindo parâmetros CGI, mas excluindo o fragmento de hash, com um limite de 5.000 caracteres. Isso geralmente é mais útil do que o URL referenciador, porque muitos navegadores enviam apenas o domínio para solicitações de terceiros.
ets

string (int64 format)

O carimbo de data/hora do evento em milissegundos. Isso evita o armazenamento em cache do navegador de solicitações GET idênticas. O nome é abreviado para reduzir os bytes do payload.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se for bem-sucedida, a resposta será uma resposta HTTP genérica que tem o formato definido pelo método.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.