Method: projects.locations.dataStores.userEvents.import

Importation groupée d'événements utilisateur. Le traitement des requêtes peut être synchrone. Les événements qui existent déjà sont ignorés. Utilisez cette méthode pour renseigner des événements utilisateur historiques.

Operation.response est du type ImportResponse. Notez qu'il est possible qu'un sous-ensemble des éléments soit inséré. Operation.metadata est du type ImportMetadata.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de la ressource DataStore parente, au format projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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.
}
Champs
errorConfig

object (ImportErrorConfig)

Emplacement souhaité des erreurs survenues lors de l'importation. Ne peut pas être défini pour les importations d'événements utilisateur intégrées.
Obligatoire : source d'entrée souhaitée des données d'événement utilisateur. Voici une liste de champs mutuellement exclusifs. Au maximum, un seul de ces champs sera défini dans une réponse :
inlineSource

object (InlineSource)

Source intégrée pour le contenu d'entrée des UserEvents.
gcsSource

object (GcsSource)

Emplacement Cloud Storage pour le contenu d'entrée.
bigquerySource

object (BigQuerySource)

Source d'entrée BigQuery.
Fin des champs mutuellement exclusifs.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

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 page Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource parent :

  • discoveryengine.userEvents.import

Pour en savoir plus, consultez la documentation IAM.