Method: projects.locations.userEvents.import

Importation groupée d'événements utilisateur. Le traitement des demandes peut être synchrone. Les événements qui existent déjà sont ignorés. Utilisez cette méthode pour remplir l'historique des événements utilisateur.

Operation.response est de type ImportResponse. Notez qu'il est possible qu'un sous-ensemble d'éléments soit inséré avec succès. Operation.metadata est de type ImportMetadata.

Requête HTTP


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

Les URL utilisent 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 pour les données d'événement utilisateur. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des 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 du contenu d'entrée.

bigquerySource

object (BigQuerySource)

Source d'entrée BigQuery.

Fin des champs qui s'excluent mutuellement.

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.