Method: projects.locations.userEvents.import

Importação em massa de eventos de usuário. O processamento da solicitação pode ser síncrono. Os eventos que já existem são ignorados. Use esse método para preencher eventos históricos do usuário.

Operation.response é do tipo ImportResponse. É possível que um subconjunto dos itens seja inserido com sucesso. Operation.metadata é do tipo ImportMetadata.

Solicitação HTTP

POST https://discoveryengine.googleapis.com/v1/{parent=projects/*/locations/*}/userEvents:import

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Nome do recurso pai do DataStore, no formato projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "errorConfig": {
    object (ImportErrorConfig)
  },

  // Union field source can be only one of the following:
  "inlineSource": {
    object (InlineSource)
  },
  "gcsSource": {
    object (GcsSource)
  },
  "bigquerySource": {
    object (BigQuerySource)
  }
  // End of list of possible types for union field source.
}
Campos
errorConfig

object (ImportErrorConfig)

O local desejado dos erros ocorridos durante a importação. Não pode ser definido para importações in-line de eventos de usuário.

Campo de união source. Obrigatório: a origem de entrada desejada dos dados de eventos do usuário. source pode ser apenas de um dos tipos a seguir:
inlineSource

object (InlineSource)

A origem inline do conteúdo de entrada para UserEvents.

gcsSource

object (GcsSource)

Local do Cloud Storage para o conteúdo de entrada.

bigquerySource

object (BigQuerySource)

Origem de entrada do BigQuery.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

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.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • discoveryengine.userEvents.import

Para mais informações, consulte a documentação do IAM.