Package google.ads.datamanager.v1

Index

IngestionService

Service permettant d'envoyer des données d'audience vers des destinations compatibles.

IngestAudienceMembers

rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)

Importe une liste de ressources AudienceMember dans le Destination fourni.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)

Importe une liste de ressources Event à partir du Destination fourni.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

Supprime une liste de ressources AudienceMember du Destination fourni.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse)

Obtient l'état d'une requête à partir de son ID.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

AdIdentifiers

Identifiants et autres informations utilisés pour faire correspondre l'événement de conversion à d'autres activités en ligne (comme les clics sur les annonces).

Champs
session_attributes

string

Facultatif. Attributs de session pour l'attribution et la modélisation des événements.
gclid

string

Facultatif. ID de clic Google (gclid) associé à cet événement.
gbraid

string

Facultatif. Identifiant des clics associés aux événements d'application et provenant d'appareils iOS (à partir d'iOS 14).
wbraid

string

Facultatif. Identifiant des clics associés aux événements Web et provenant d'appareils iOS (à partir d'iOS 14).
landing_page_device_info

DeviceInfo

Facultatif. Informations recueillies sur l'appareil utilisé (le cas échéant) au moment de l'arrivée sur le site de l'annonceur après l'interaction avec l'annonce.

AddressInfo

Informations sur l'adresse de l'utilisateur.

Champs
given_name

string

Obligatoire. Prénom de l'utilisateur, en minuscules, sans ponctuation, sans espace de début ni de fin, et haché au format SHA-256.
family_name

string

Obligatoire. Nom de famille de l'utilisateur, en minuscules, sans ponctuation, sans espace de début ni de fin, et haché au format SHA-256.
region_code

string

Obligatoire. Code de région à deux lettres au format ISO-3166-1 alpha-2 de l'adresse de l'utilisateur.
postal_code

string

Obligatoire. Code postal de l'adresse de l'utilisateur.

AudienceMember

Membre de l'audience sur lequel effectuer l'opération.

Champs
destination_references[]

string

Facultatif. Définit la Destination vers laquelle rediriger le membre de l'audience.
consent

Consent

Facultatif. Paramètre de consentement de l'utilisateur.
Champ d'union data. Type de données d'identification à traiter. data ne peut être qu'un des éléments suivants :
user_data

UserData

Données fournies par l'utilisateur qui l'identifient.
pair_data

PairData

ID Publisher Advertiser Identity Reconciliation (PAIR)
mobile_data

MobileData

Données permettant d'identifier les appareils mobiles de l'utilisateur.

CartData

Données du panier associées à l'événement.

Champs
merchant_id

string

Facultatif. ID Merchant Center associé aux articles.
merchant_feed_label

string

Facultatif. Libellé du flux Merchant Center associé au flux des articles.
merchant_feed_language_code

string

Facultatif. Code de langue ISO 639-1 associé au flux Merchant Center des articles dans lequel vos articles sont importés.
transaction_discount

double

Facultatif. Somme de toutes les remises associées à la transaction.
items[]

Item

Facultatif. Liste des éléments associés à l'événement.

Paramètres de consentement de l'utilisateur pour la loi sur les marchés numériques (DMA, Digital Markets Act).

Champs
ad_user_data

ConsentStatus

Facultatif. Indique si l'utilisateur accepte les données utilisateur publicitaires.
ad_personalization

ConsentStatus

Facultatif. Indique si l'utilisateur accepte la personnalisation des annonces.

ConsentStatus

Indique si l'utilisateur a accordé ou refusé son consentement, ou s'il ne l'a pas spécifié.

Enums
CONSENT_STATUS_UNSPECIFIED Non spécifié.
CONSENT_GRANTED Accordé.
CONSENT_DENIED Refusée.

Variable personnalisée

Variable personnalisée pour les conversions d'annonces.

Champs
variable

string

Facultatif. Nom de la variable personnalisée à définir. Si la variable n'est pas trouvée pour la destination indiquée, elle sera ignorée.
value

string

Facultatif. Valeur à stocker pour la variable personnalisée.
destination_references[]

string

Facultatif. Chaîne de référence utilisée pour déterminer à quel Event.destination_references la variable personnalisée doit être envoyée. Si ce champ est vide, le Event.destination_references sera utilisé.

CustomerType

Type de client associé à l'événement.

Enums
CUSTOMER_TYPE_UNSPECIFIED Type de client non spécifié. Ce type ne doit jamais être utilisé.
NEW Le client est nouveau pour l'annonceur.
RETURNING Le client revient vers l'annonceur.
REENGAGED Le client a de nouveau interagi avec l'annonceur.

CustomerValueBucket

Valeur du client évaluée par l'annonceur.

Enums
CUSTOMER_VALUE_BUCKET_UNSPECIFIED Bucket de valeur client non spécifié. Ce type ne doit jamais être utilisé.
LOW Le client a un faible potentiel.
MEDIUM Le client a un potentiel moyen.
HIGH Le client est à fort potentiel.

Destination

Produit Google vers lequel vous envoyez des données. (par exemple, un compte Google Ads).

Champs
reference

string

Facultatif. ID de cette ressource Destination, unique dans la requête. Permet de faire référence à Destination dans IngestEventsRequest et IngestAudienceMembersRequest.
login_account

ProductAccount

Facultatif. Compte utilisé pour effectuer cet appel d'API. Pour ajouter ou supprimer des données du operating_account, ce login_account doit disposer d'un accès en écriture au operating_account. Par exemple, un compte administrateur de operating_account ou un compte associé à operating_account.
linked_account

ProductAccount

Facultatif. Compte auquel le login_account de l'utilisateur appelant a accès via une association de compte établie. Par exemple, le login_account d'un partenaire de données peut avoir accès au linked_account d'un client. Le partenaire peut utiliser ce champ pour envoyer des données du linked_account à un autre operating_account.
operating_account

ProductAccount

Obligatoire. Compte vers lequel envoyer les données ou depuis lequel les supprimer.
product_destination_id

string

Obligatoire. Objet du compte produit à ingérer. Par exemple, un ID d'audience Google Ads, un ID d'audience Display & Video 360 ou un ID d'action de conversion Google Ads.

DeviceInfo

Informations sur l'appareil utilisé (le cas échéant) lors de l'événement.

Champs
user_agent

string

Facultatif. Chaîne user-agent de l'appareil pour le contexte donné.
ip_address

string

Facultatif. Adresse IP de l'appareil pour le contexte donné.

Remarque : Google Ads n'est pas compatible avec la mise en correspondance des adresses IP pour les utilisateurs finaux de l'Espace économique européen (EEE), du Royaume-Uni (UK) ou de la Suisse (CH). Ajoutez une logique pour exclure conditionnellement le partage des adresses IP des utilisateurs de ces régions. Assurez-vous également de fournir aux utilisateurs des informations claires et complètes sur les données que vous collectez sur vos sites, applications et autres propriétés, et d'obtenir leur consentement lorsque la loi ou les règles Google applicables l'exigent. Pour en savoir plus, consultez la page À propos de l'importation des conversions hors connexion.

Encodage

Type d'encodage des informations d'identification hachées.

Enums
ENCODING_UNSPECIFIED Type d'encodage non spécifié. Ce type ne doit jamais être utilisé.
HEX Encodage hexadécimal.
BASE64 Encodage Base64.

EncryptionInfo

Informations sur le chiffrement des données ingérées.

Champs
Champ d'union wrapped_key. La clé encapsulée utilisée pour chiffrer les données. La wrapped_key ne peut être qu'un des éléments suivants :
gcp_wrapped_key_info

GcpWrappedKeyInfo

Informations sur la clé encapsulée Google Cloud Platform.

ErrorCount

Nombre d'erreurs pour une raison donnée.

Champs
record_count

int64

Nombre d'enregistrements dont l'importation a échoué pour une raison donnée.
reason

ProcessingErrorReason

Motif de l'erreur pour les enregistrements ayant échoué.

Information sur l'erreur

Nombre d'erreurs pour chaque type d'erreur.

Champs
error_counts[]

ErrorCount

Liste des erreurs et du nombre d'erreurs par motif. Il est possible qu'il ne soit pas renseigné dans tous les cas.

Événement

Événement représentant une interaction utilisateur avec le site Web ou l'application d'un annonceur.

Champs
destination_references[]

string

Facultatif. Chaîne de référence utilisée pour déterminer la destination. Si ce champ est vide, l'événement sera envoyé à tous les destinations de la requête.
transaction_id

string

Facultatif. Identifiant unique de cet événement. Obligatoire pour les conversions utilisant plusieurs sources de données.
event_timestamp

Timestamp

Obligatoire. Heure à laquelle l'événement s'est produit.
last_updated_timestamp

Timestamp

Facultatif. Date de la dernière mise à jour de l'événement.
user_data

UserData

Facultatif. Éléments de données fournies par l'utilisateur, représentant l'utilisateur auquel l'événement est associé.
consent

Consent

Facultatif. Informations indiquant si l'utilisateur associé a donné différents types de consentement.
ad_identifiers

AdIdentifiers

Facultatif. Identifiants et autres informations utilisés pour faire correspondre l'événement de conversion à d'autres activités en ligne (comme les clics sur les annonces).
currency

string

Facultatif. Code de devise associé à toutes les valeurs monétaires de cet événement.
conversion_value

double

Facultatif. Valeur de conversion associée à l'événement, pour les conversions basées sur la valeur.
event_source

EventSource

Facultatif. Signal indiquant où l'événement s'est produit (sur le Web, dans une application, en magasin, etc.).
event_device_info

DeviceInfo

Facultatif. Informations recueillies sur l'appareil utilisé (le cas échéant) au moment de l'événement.
cart_data

CartData

Facultatif. Informations sur la transaction et les articles associés à l'événement.
custom_variables[]

CustomVariable

Facultatif. Informations supplémentaires sur les paires clé/valeur à envoyer aux conteneurs de conversion (action de conversion ou activité Floodlight).
experimental_fields[]

ExperimentalField

Facultatif. Liste de paires clé/valeur pour les champs expérimentaux qui pourront éventuellement être promus pour faire partie de l'API.
user_properties

UserProperties

Facultatif. Informations évaluées par l'annonceur sur l'utilisateur au moment de l'événement.

EventSource

Source de l'événement.

Enums
EVENT_SOURCE_UNSPECIFIED EventSource non spécifié. Ce type ne doit jamais être utilisé.
WEB L'événement a été généré à partir d'un navigateur Web.
APP L'événement a été généré à partir d'une application.
IN_STORE L'événement a été généré à partir d'une transaction en magasin.
PHONE L'événement a été généré à partir d'un appel téléphonique.
OTHER L'événement a été généré à partir d'autres sources.

ExperimentalField

Champ expérimental représentant les champs non officiels.

Champs
field

string

Facultatif. Nom du champ à utiliser.
value

string

Facultatif. Valeur à définir pour le champ.

GcpWrappedKeyInfo

Informations sur la clé de chiffrement Google Cloud Platform.

Champs
key_type

KeyType

Obligatoire. Type d'algorithme utilisé pour chiffrer les données.
wip_provider

string

Obligatoire. Fournisseur de pool Workload Identity requis pour utiliser la clé de chiffrement de clé.
kek_uri

string

Obligatoire. ID de ressource Cloud Key Management Service de Google Cloud Platform. Doit être au format "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}".
encrypted_dek

string

Obligatoire. Clé de chiffrement des données chiffrées encodée en base64.

KeyType

Type d'algorithme utilisé pour chiffrer les données.

Enums
KEY_TYPE_UNSPECIFIED Type de clé non spécifié. Ce type ne doit jamais être utilisé.
XCHACHA20_POLY1305 Algorithme XChaCha20-Poly1305

IngestAudienceMembersRequest

Demande d'importer des membres d'audience vers les destinations fournies. Renvoie un IngestAudienceMembersResponse.

Vous pouvez essayer cette méthode dans l'explorateur d'API REST :
Essayer avec REST
Champs
destinations[]

Destination

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

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

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.
validate_only

bool

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

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é.
encryption_info

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é.
terms_of_service

TermsOfService

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

IngestAudienceMembersResponse

Réponse de IngestAudienceMembersRequest.

Champs
request_id

string

ID de la demande généré automatiquement.

IngestEventsRequest

Demande d'importer des membres d'audience vers les destinations fournies. Renvoie un IngestEventsResponse.

Vous pouvez essayer cette méthode dans l'explorateur d'API REST :
Essayer avec REST
Champs
destinations[]

Destination

Obligatoire. Liste des destinations auxquelles envoyer les événements.
events[]

Event

Obligatoire. Liste des événements à envoyer aux destinations spécifiées. Vous pouvez envoyer jusqu'à 2 000 ressources Event dans une même requête.
consent

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 Event.
validate_only

bool

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

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é.
encryption_info

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é.

IngestEventsResponse

Réponse de IngestEventsRequest.

Champs
request_id

string

ID de la demande généré automatiquement.

Élément

Représente un article du panier associé à l'événement.

Champs
merchant_product_id

string

Facultatif. ID du produit dans le compte Merchant Center.
quantity

int64

Facultatif. Nombre de cet article associé à l'événement.
unit_price

double

Facultatif. Prix unitaire hors taxes, frais de port et toute remise appliquée aux transactions.

MatchRateRange

Plage du taux de correspondance de la liste importée ou de la liste d'utilisateurs.

Enums
MATCH_RATE_RANGE_UNKNOWN La plage du taux de correspondance est inconnue.
MATCH_RATE_RANGE_NOT_ELIGIBLE La plage de taux de correspondance n'est pas éligible.
MATCH_RATE_RANGE_LESS_THAN_20 La plage du taux de correspondance est inférieure à 20 % (dans l'intervalle [0, 20)).
MATCH_RATE_RANGE_20_TO_30 Le taux de correspondance est compris entre 20 % et 30 % (dans l'intervalle [20, 31)).
MATCH_RATE_RANGE_31_TO_40 La plage du taux de correspondance est comprise entre 31 % et 40 % (dans l'intervalle [31, 41)).
MATCH_RATE_RANGE_41_TO_50 Le taux de correspondance est compris entre 41 % et 50 % (dans l'intervalle [41, 51)).
MATCH_RATE_RANGE_51_TO_60 Le taux de correspondance est compris entre 51 % et 60 % (dans l'intervalle [51, 61)).
MATCH_RATE_RANGE_61_TO_70 Le taux de correspondance est compris entre 61 % et 70 % (dans l'intervalle [61, 71)).
MATCH_RATE_RANGE_71_TO_80 Le taux de correspondance est compris entre 71 % et 80 % (dans l'intervalle [71, 81)).
MATCH_RATE_RANGE_81_TO_90 Le taux de correspondance est compris entre 81 % et 90 % (dans l'intervalle [81, 91)).
MATCH_RATE_RANGE_91_TO_100

La plage du taux de correspondance est comprise entre 91 % et 100 % (dans l'intervalle [91, 100]).

MobileData

ID mobiles pour l'audience. Vous devez indiquer au moins un ID mobile.

Champs
mobile_ids[]

string

Obligatoire. Liste des ID d'appareils mobiles (identifiant publicitaire/IDFA). Vous ne pouvez pas fournir plus de 10 mobileIds dans un seul AudienceMember.

PairData

ID PAIR pour l'audience. Vous devez indiquer au moins un ID PAIR.

Champs
pair_ids[]

string

Obligatoire. Données permettant d'identifier personnellement l'utilisateur fournies par la salle blanche, hachées avec SHA256 et chiffrées avec un chiffrement commutatif EC à l'aide de la clé de l'éditeur pour la liste des utilisateurs PAIR. Vous ne pouvez pas fournir plus de 10 pairIds dans un seul AudienceMember.

ProcessingErrorReason

Raison de l'erreur de traitement.

Enums
PROCESSING_ERROR_REASON_UNSPECIFIED Le motif de l'erreur de traitement est inconnu.
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE La variable personnalisée n'est pas valide.
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED L'état de la variable personnalisée n'est pas "Activée".
PROCESSING_ERROR_REASON_EVENT_TOO_OLD La conversion est plus ancienne que l'ancienneté maximale autorisée.
PROCESSING_ERROR_REASON_DUPLICATE_GCLID Une conversion associée au même GCLID, et aux mêmes date et heure existe déjà dans le système.
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID Une conversion présentant la même combinaison d'ID de commande et d'action de conversion a déjà été importée.
PROCESSING_ERROR_REASON_INVALID_GBRAID Impossible de décoder le gbraid.
PROCESSING_ERROR_REASON_INVALID_GCLID Impossible de décoder l'ID de clic Google.
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID L'ID du marchand contient des caractères non numériques.
PROCESSING_ERROR_REASON_INVALID_WBRAID Impossible de décoder le wbraid.
PROCESSING_ERROR_REASON_INTERNAL_ERROR Erreur interne.
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Les conditions d'utilisation du suivi avancé des conversions n'ont pas été signées dans le compte de destination.
PROCESSING_ERROR_REASON_INVALID_EVENT L'événement n'est pas valide.
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS Le nombre de transactions correspondantes est inférieur au seuil minimal.
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS Les transactions sont inférieures au seuil minimal.
PROCESSING_ERROR_REASON_INVALID_FORMAT L'événement présente une erreur de format.
PROCESSING_ERROR_REASON_DECRYPTION_ERROR L'événement présente une erreur de déchiffrement.
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR Échec du déchiffrement de la clé DEK.
PROCESSING_ERROR_REASON_INVALID_WIP Le format du numéro de série n'est pas valide ou le numéro de série n'existe pas.
PROCESSING_ERROR_REASON_INVALID_KEK La KEK ne peut pas déchiffrer les données, car il s'agit de la mauvaise KEK ou qu'elle n'existe pas.
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED Le pool d'identités de charge de travail n'a pas pu être utilisé, car il a été refusé par sa condition d'attestation.
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED Le système ne disposait pas des autorisations nécessaires pour accéder à la clé KEK.
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR Échec du déchiffrement des données UserIdentifier à l'aide de la clé DEK.
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER L'utilisateur a tenté d'ingérer des événements avec un identifiant publicitaire qui ne provient pas des annonces du compte d'exploitation.

ProcessingWarningReason

Motif de l'avertissement de traitement.

Enums
PROCESSING_WARNING_REASON_UNSPECIFIED Le motif de l'avertissement de traitement est inconnu.
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED Le système ne disposait pas des autorisations nécessaires pour accéder à la clé KEK.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR Échec du déchiffrement de la clé DEK.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR L'événement présente une erreur de déchiffrement.
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED Le pool d'identités de charge de travail n'a pas pu être utilisé, car il a été refusé par sa condition d'attestation.
PROCESSING_WARNING_REASON_INVALID_WIP Le format du numéro de série n'est pas valide ou le numéro de série n'existe pas.
PROCESSING_WARNING_REASON_INVALID_KEK La KEK ne peut pas déchiffrer les données, car il s'agit de la mauvaise KEK ou qu'elle n'existe pas.
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR Échec du déchiffrement des données UserIdentifier à l'aide de la clé DEK.
PROCESSING_WARNING_REASON_INTERNAL_ERROR Erreur interne.

Produit

Obsolète. Utilisez AccountType à la place. Représente un produit Google spécifique.

Enums
PRODUCT_UNSPECIFIED Produit non spécifié. Ce type ne doit jamais être utilisé.
GOOGLE_ADS Google Ads
DISPLAY_VIDEO_PARTNER Partenaire Display & Video 360.
DISPLAY_VIDEO_ADVERTISER Annonceur Display & Video 360.
DATA_PARTNER Partenaire pour les données.

ProductAccount

Représente un compte spécifique.

Champs
product
(deprecated)

Product

Obsolète. Utilisez account_type à la place.
account_id

string

Obligatoire. ID du compte. Par exemple, l'ID de votre compte Google Ads.
account_type

AccountType

Facultatif. Type de compte. Par exemple, GOOGLE_ADS. account_type ou product (obsolète) est obligatoire. Si les deux sont définis, les valeurs doivent correspondre.

AccountType

Représente les types de comptes Google. Permet de localiser des comptes et des destinations.

Enums
ACCOUNT_TYPE_UNSPECIFIED Produit non spécifié. Ce type ne doit jamais être utilisé.
GOOGLE_ADS Google Ads
DISPLAY_VIDEO_PARTNER Partenaire Display & Video 360.
DISPLAY_VIDEO_ADVERTISER Annonceur Display & Video 360.
DATA_PARTNER Partenaire pour les données.

RemoveAudienceMembersRequest

Demande de suppression d'utilisateurs d'une audience dans les destinations fournies. Renvoie un objet RemoveAudienceMembersResponse.

Vous pouvez essayer cette méthode dans l'explorateur d'API REST :
Essayer avec REST
Champs
destinations[]

Destination

Obligatoire. Liste des destinations desquelles supprimer les utilisateurs.
audience_members[]

AudienceMember

Obligatoire. Liste des utilisateurs à supprimer.
validate_only

bool

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

Encoding

Facultatif. Obligatoire pour les importations UserData. Type d'encodage des identifiants utilisateur. Ne s'applique qu'à l'encodage externe des identifiants utilisateur chiffrés. Pour les importations autres que UserData, ce champ est ignoré.
encryption_info

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é.

RemoveAudienceMembersResponse

Réponse de RemoveAudienceMembersRequest.

Champs
request_id

string

ID de la demande généré automatiquement.

RequestStatusPerDestination

Un état de la demande par destination.

Champs
destination

Destination

Destination dans une requête API DM.
request_status

RequestStatus

État de la demande de la destination.
error_info

ErrorInfo

Informations sur l'erreur contenant le motif et le nombre d'erreurs liées à l'importation.
warning_info

WarningInfo

Informations d'avertissement contenant le motif et le nombre d'avertissements liés à l'importation.
Champ d'union status. État de la destination. status ne peut être qu'un des éléments suivants :
audience_members_ingestion_status

IngestAudienceMembersStatus

État de la demande d'importation des membres de l'audience.
events_ingestion_status

IngestEventsStatus

État de la demande d'événements d'ingestion.
audience_members_removal_status

RemoveAudienceMembersStatus

État de la demande de suppression de membres de l'audience.

IngestAudienceMembersStatus

État de la demande d'importation des membres de l'audience.

Champs
Champ d'union status. État de l'importation des membres de l'audience vers la destination. status ne peut être qu'un des éléments suivants :
user_data_ingestion_status

IngestUserDataStatus

État de l'ingestion des données utilisateur dans la destination.
mobile_data_ingestion_status

IngestMobileDataStatus

État de l'ingestion des données mobiles dans la destination.
pair_data_ingestion_status

IngestPairDataStatus

État de l'ingestion des données de la paire dans la destination.

IngestEventsStatus

État de l'ingestion des événements dans la destination.

Champs
record_count

int64

Nombre total d'événements envoyés dans la demande d'importation. Inclut tous les événements de la requête, qu'ils aient été ingérés ou non.

IngestMobileDataStatus

État de l'ingestion des données mobiles dans la destination contenant des statistiques liées à l'ingestion.

Champs
record_count

int64

Nombre total de membres de l'audience envoyés dans la demande d'importation pour la destination. Inclut tous les membres de l'audience dans la demande, qu'ils aient été ingérés ou non.
mobile_id_count

int64

Nombre total d'ID mobiles envoyés dans la demande d'importation pour la destination. Inclut tous les ID mobiles de la requête, qu'ils aient été ingérés ou non.

IngestPairDataStatus

État de l'ingestion des données de paire dans la destination contenant les statistiques associées.

Champs
record_count

int64

Nombre total de membres de l'audience envoyés dans la demande d'importation pour la destination. Inclut tous les membres de l'audience dans la demande, qu'ils aient été ingérés ou non.
pair_id_count

int64

Nombre total d'ID de paires envoyés dans la demande d'importation pour la destination. Inclut tous les ID de paires dans la requête, qu'ils aient été ingérés ou non.

IngestUserDataStatus

État de l'importation des données utilisateur vers la destination contenant des statistiques liées à l'importation.

Champs
record_count

int64

Nombre total de membres de l'audience envoyés dans la demande d'importation pour la destination. Inclut tous les membres de l'audience dans la demande, qu'ils aient été ingérés ou non.
user_identifier_count

int64

Nombre total d'identifiants utilisateur envoyés dans la demande d'importation pour la destination. Inclut tous les identifiants utilisateur de la requête, qu'ils aient été ingérés ou non.
upload_match_rate_range

MatchRateRange

Plage du taux de correspondance de l'importation.

RemoveAudienceMembersStatus

État de la demande de suppression de membres de l'audience.

Champs
Champ d'union status. État de la suppression des membres de l'audience de la destination. status ne peut être qu'un des éléments suivants :
user_data_removal_status

RemoveUserDataStatus

État de la suppression des données utilisateur de la destination.
mobile_data_removal_status

RemoveMobileDataStatus

État de la suppression des données mobiles de la destination.
pair_data_removal_status

RemovePairDataStatus

État de la suppression des données d'association de la destination.

RemoveMobileDataStatus

État de la suppression des données mobiles de la destination.

Champs
record_count

int64

Nombre total de membres de l'audience inclus dans la demande de suppression. Inclut tous les membres de l'audience dans la requête, qu'ils aient été supprimés ou non.
mobile_id_count

int64

Nombre total d'ID mobiles envoyés dans la demande de suppression. Inclut tous les ID mobiles de la demande, qu'ils aient été supprimés ou non.

RemovePairDataStatus

État de la suppression des données d'association de la destination.

Champs
record_count

int64

Nombre total de membres de l'audience inclus dans la demande de suppression. Inclut tous les membres de l'audience dans la requête, qu'ils aient été supprimés ou non.
pair_id_count

int64

Nombre total d'ID de paires envoyés dans la demande de suppression. Inclut tous les ID de paires dans la requête, qu'ils aient été supprimés ou non.

RemoveUserDataStatus

État de la suppression des données utilisateur de la destination.

Champs
record_count

int64

Nombre total de membres de l'audience inclus dans la demande de suppression. Inclut tous les membres de l'audience dans la requête, qu'ils aient été supprimés ou non.
user_identifier_count

int64

Nombre total d'identifiants utilisateur envoyés dans la demande de suppression. Inclut tous les identifiants utilisateur de la demande, qu'ils aient été supprimés ou non.

RequestStatus

État de la demande.

Enums
REQUEST_STATUS_UNKNOWN L'état de la demande est inconnu.
SUCCESS La demande a été traitée.
PROCESSING La demande est en cours de traitement.
FAILED Échec de la requête.
PARTIAL_SUCCESS La demande a été partiellement traitée.

RetrieveRequestStatusRequest

Requête permettant d'obtenir l'état d'une requête envoyée à l'API DM pour un ID de requête donné. Renvoie un objet RetrieveRequestStatusResponse.

Vous pouvez essayer cette méthode dans l'explorateur d'API REST :
Essayer avec REST
Champs
request_id

string

Obligatoire. Obligatoire. ID de la requête API Data Manager.

RetrieveRequestStatusResponse

Réponse de RetrieveRequestStatusRequest.

Champs
request_status_per_destination[]

RequestStatusPerDestination

Liste des états des demandes par destination. L'ordre des états correspond à l'ordre des destinations dans la requête d'origine.

TermsOfService

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

Champs
customer_match_terms_of_service_status

TermsOfServiceStatus

Facultatif. Conditions d'utilisation du ciblage par liste de clients : https://support.google.com/adspolicy/answer/6299717 Vous devez l'accepter lorsque vous ingérez UserData ou MobileData. Ce champ n'est pas obligatoire pour les listes d'utilisateurs pour le ciblage des 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.

UserData

Données permettant d'identifier l'utilisateur. Vous devez indiquer au moins un identifiant.

Champs
user_identifiers[]

UserIdentifier

Obligatoire. Identifiants de l'utilisateur. Il est possible de fournir plusieurs instances du même type de données (par exemple, plusieurs adresses e-mail). Pour augmenter la probabilité d'une correspondance, fournissez autant d'identifiants que possible. Vous ne pouvez pas fournir plus de 10 userIdentifiers dans un seul AudienceMember ou Event.

UserIdentifier

Identifiant unique de l'utilisateur.

Champs
Champ d'union identifier. Vous ne devez en spécifier qu'un seul. identifier ne peut être qu'un des éléments suivants :
email_address

string

Adresse e-mail hachée à l'aide de la fonction de hachage SHA-256 après normalisation.
phone_number

string

Numéro de téléphone haché à l'aide de la fonction de hachage SHA-256 après normalisation (norme E164).
address

AddressInfo

Composants connus de l'adresse d'un utilisateur. Contient un regroupement d'identifiants qui sont mis en correspondance en même temps.

UserProperties

Informations évaluées par l'annonceur sur l'utilisateur au moment de l'événement. Pour en savoir plus, consultez https://support.google.com/google-ads/answer/14007601.

Champs
customer_type

CustomerType

Facultatif. Type de client associé à l'événement.
customer_value_bucket

CustomerValueBucket

Facultatif. Valeur du client évaluée par l'annonceur.

WarningCount

Nombre d'avertissements pour un motif donné.

Champs
record_count

int64

Nombre d'enregistrements comportant un avertissement.
reason

ProcessingWarningReason

Motif de l'avertissement.

WarningInfo

Nombre d'avertissements pour chaque type d'avertissement.

Champs
warning_counts[]

WarningCount

Liste des avertissements et du nombre d'avertissements par motif.