Method: projects.locations.userEvents.collect

Grava um único evento de usuário do 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. Nome do recurso pai. Se a ação de evento de usuário de coleta for aplicada no nível DataStore, o formato será: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}. Se a ação de evento de usuário de coleta 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 comprimento de 2.000.000 de caracteres.
uri

string

O URL, incluindo parâmetros cgi, mas excluindo o fragmento de hash com um limite de comprimento de 5.000 caracteres. Isso geralmente é mais útil do que o URL de referência, 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 impede o processo de cache do navegador de solicitações get idênticas. O nome é abreviado para reduzir os bytes de 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.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Para mais informações, consulte Authentication Overview.