Method: projects.locations.collections.dataStores.userEvents.import

Importación masiva de eventos de usuario. El procesamiento de la solicitud puede ser síncrono. Se omiten los eventos que ya existen. Usa este método para completar eventos históricos de usuario.

Operation.response es del tipo ImportResponse. Ten en cuenta que es posible que se inserte correctamente un subconjunto de los elementos. Operation.metadata es del tipo ImportMetadata.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Nombre del recurso DataStore superior, con el formato projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "errorConfig": {
    object (ImportErrorConfig)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "inlineSource": {
    object (InlineSource)
  },
  "gcsSource": {
    object (GcsSource)
  },
  "bigquerySource": {
    object (BigQuerySource)
  }
  // End of mutually exclusive fields.
}
Campos
errorConfig

object (ImportErrorConfig)

Es la ubicación deseada de los errores que se produjeron durante la importación. No se puede configurar para las importaciones de eventos de usuario intercalados.

Obligatorio: Es la fuente de entrada deseada de los datos de eventos de usuario. A continuación, se incluye una lista de campos mutuamente excluyentes. Se establecerá como máximo uno de los campos en una respuesta:
inlineSource

object (InlineSource)

Es la fuente intercalada para el contenido de entrada de UserEvents.

gcsSource

object (GcsSource)

Es la ubicación de Cloud Storage para el contenido de entrada.

bigquerySource

object (BigQuerySource)

Es la fuente de entrada de BigQuery.

Fin de los campos mutuamente excluyentes.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Se necesita uno de los siguientes permisos de 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 obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • discoveryengine.userEvents.import

Para obtener más información, consulta la documentación de IAM.