Method: users.ingest

Importe une liste d'utilisateurs vers les destinations fournies. Contrairement à audienceMembers.ingest (qui ajoute des utilisateurs à des listes d'audience d'annonceurs spécifiques pour le ciblage), users.ingest ingère des données d'association d'identité au niveau du compte (par exemple, des identifiants utilisateur associés à des ID mobiles) indépendamment des segments d'audience spécifiques.

Cette fonctionnalité n'est disponible que pour les comptes figurant sur une liste d'autorisation.

Requête HTTP

POST https://datamanager.googleapis.com/v1/users:ingest

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

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

Représentation JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "users": [
    {
      object (User)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding)
}
Champs
destinations[]

object (Destination)

Obligatoire. Liste des destinations d'ingestion possibles.
users[]

object (User)

Obligatoire. Liste des utilisateurs à ingérer.
encryptionInfo

object (EncryptionInfo)

Facultatif. Informations sur le chiffrement des clés utilisées pour chiffrer les données.
validateOnly

boolean

Facultatif. Si la valeur est true, la requête est validée, mais pas exécutée.
encoding

enum (Encoding)

Obligatoire. Type d'encodage des identifiants utilisateur. Pour les identifiants utilisateur chiffrés, cela ne s'applique qu'à l'encodage externe.

Corps de la réponse

Réponse à IngestUsersRequest.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "requestId": string
}
Champs
requestId

string

ID de la demande d'ingestion généré.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/datamanager

Utilisateur

Représente un seul utilisateur et contient des identifiants tels que des informations permettant d'identifier personnellement l'utilisateur et des ID d'appareils mobiles qui font tous référence au même utilisateur.

Représentation JSON 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
Champs
userData

object (UserData)

Obligatoire. Plusieurs éléments de données fournies par l'utilisateur, utilisés pour l'identifier.
mobileData

object (MobileData)

Obligatoire. Plusieurs chaînes d'ID d'appareils mobiles représentant un seul utilisateur.