Method: audienceMembers.ingest

Importe une liste de ressources AudienceMember vers la Destination fournie.

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 envoyer les membres de l'audience.

audienceMembers[]

object (AudienceMember)

Obligatoire. Liste des utilisateurs à envoyer vers les destinations spécifiées. Vous pouvez envoyer au maximum 10 000 ressources AudienceMember dans une seule requête.

consent

object (Consent)

Facultatif. Consentement au niveau de la requête à appliquer à tous les utilisateurs de la requête. Le consentement au niveau de l'utilisateur remplace le consentement au niveau de la requête 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, pas les résultats.

encoding

enum (Encoding)

Facultatif. Doit être fourni 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 d'une manière différente de la chaîne chiffrée externe. Pour les importations autres que UserData, ce champ est ignoré.

encryptionInfo

object (EncryptionInfo)

Facultatif. Informations de chiffrement pour les importations UserData. Si aucune valeur n'est définie, on suppose que les informations d'identification importées sont 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 la 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,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
Champs
requestId

string

ID généré automatiquement de la requête.

fieldWarnings[]

object (FieldWarning)

Avertissements détaillés au niveau des lignes avec des chemins de champ.

Niveaux d'accès 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 les accepter lorsque vous importez des données UserData ou MobileData. Ce champ n'est pas obligatoire pour la liste d'utilisateurs ciblage par liste de partenaires.

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.