Method: audienceMembers.ingest

Importe une liste de ressources AudienceMember dans le Destination fourni.

Requête HTTP

POST https://datamanager.googleapis.com/v1/audienceMembers: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)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
Champs
destinations[]

object (Destination)

Obligatoire. Liste des destinations vers lesquelles rediriger les membres de l'audience.
audienceMembers[]

object (AudienceMember)

Obligatoire. Liste des utilisateurs à envoyer vers les destinations spécifiées. Vous ne pouvez pas envoyer plus de 10 000 ressources AudienceMember dans une même requête.
consent

object (Consent)

Facultatif. Consentement au niveau de la demande à appliquer à tous les utilisateurs de la demande. Le consentement au niveau de l'utilisateur remplace celui au niveau de la demande et peut être spécifié dans chaque AudienceMember.
validateOnly

boolean

Facultatif. À des fins de test. Si la valeur est true, la requête est validée, mais pas exécutée. Seules les erreurs sont renvoyées, et non les résultats.
encoding

enum (Encoding)

Facultatif. Obligatoire pour les importations UserData. Type d'encodage des identifiants utilisateur. Pour les identifiants utilisateur hachés, il s'agit du type d'encodage de la chaîne hachée. Pour les identifiants utilisateur hachés chiffrés, il s'agit du type d'encodage de la chaîne chiffrée externe, mais pas nécessairement de la chaîne hachée interne. Cela signifie que la chaîne hachée interne peut être encodée différemment de la chaîne chiffrée externe. Pour les importations autres que UserData, ce champ est ignoré.
encryptionInfo

object (EncryptionInfo)

Facultatif. Informations sur le chiffrement des importations UserData. Si elle n'est pas définie, les informations d'identification importées sont considérées comme hachées, mais pas chiffrées. Pour les importations autres que UserData, ce champ est ignoré.
termsOfService

object (TermsOfService)

Facultatif. Conditions d'utilisation que l'utilisateur a acceptées ou refusées.

Corps de la réponse

Réponse de IngestAudienceMembersRequest.

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 généré automatiquement pour la demande.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

TermsOfService

Conditions d'utilisation que l'utilisateur a acceptées ou refusées.

Représentation JSON 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
Champs
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

Facultatif. Conditions d'utilisation du ciblage par liste de clients : https://support.google.com/adspolicy/answer/6299717. Vous devez accepter ces conditions pour importer des listes d'utilisateurs pour le ciblage par liste de clients.

TermsOfServiceStatus

Représente la décision de l'appelant d'accepter ou de refuser les conditions d'utilisation.

Enums
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Non spécifié.
ACCEPTED État indiquant que l'appelant a choisi d'accepter les conditions d'utilisation.
REJECTED État indiquant que l'appelant a choisi de refuser les conditions d'utilisation.