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

MarketingDataInsightsService

Service permettant de renvoyer des insights sur les données marketing.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

RetrieveInsights

rpc RetrieveInsights(RetrieveInsightsRequest) returns (RetrieveInsightsResponse)

Récupère des insights sur les données marketing pour une liste d'utilisateurs donnée.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

En-têtes d'autorisation :

Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :

  • login-account : (facultatif) nom de ressource du compte dont le compte Google des identifiants est un utilisateur. Si ce champ n'est pas défini, la valeur par défaut est le compte de la demande. Format : accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account : (facultatif) nom de ressource du compte avec un lien produit établi vers login-account. Format : accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

PartnerLinkService

Service permettant de gérer les liens de partenaires.

UserListDirectLicenseService

Service permettant de gérer les licences directes de listes d'utilisateurs. La suppression n'est pas une opération acceptée pour UserListDirectLicenses. Les appelants doivent définir l'état de la licence sur "DISABLED" (DÉSACTIVÉE) pour la désactiver.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

CreateUserListDirectLicense

rpc CreateUserListDirectLicense(CreateUserListDirectLicenseRequest) returns (UserListDirectLicense)

Crée une licence directe pour une liste d'utilisateurs.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc GetUserListDirectLicense(GetUserListDirectLicenseRequest) returns (UserListDirectLicense)

Récupère une licence directe pour une liste d'utilisateurs.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc ListUserListDirectLicenses(ListUserListDirectLicensesRequest) returns (ListUserListDirectLicensesResponse)

Liste toutes les licences directes de listes d'utilisateurs détenues par le compte parent.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc UpdateUserListDirectLicense(UpdateUserListDirectLicenseRequest) returns (UserListDirectLicense)

Met à jour une licence directe de liste d'utilisateurs.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

UserListGlobalLicenseService

Service permettant de gérer les licences globales de listes d'utilisateurs. La suppression n'est pas une opération acceptée pour UserListGlobalLicenses. Les appelants doivent définir l'état de la licence sur "DISABLED" (DÉSACTIVÉE) pour la désactiver.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

CreateUserListGlobalLicense

rpc CreateUserListGlobalLicense(CreateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Crée une licence globale pour une liste d'utilisateurs.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc GetUserListGlobalLicense(GetUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Récupère une licence globale de liste d'utilisateurs.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc ListUserListGlobalLicenseCustomerInfos(ListUserListGlobalLicenseCustomerInfosRequest) returns (ListUserListGlobalLicenseCustomerInfosResponse)

Liste toutes les informations client pour une licence globale de liste d'utilisateurs.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc ListUserListGlobalLicenses(ListUserListGlobalLicensesRequest) returns (ListUserListGlobalLicensesResponse)

Liste toutes les licences globales de listes d'utilisateurs détenues par le compte parent.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc UpdateUserListGlobalLicense(UpdateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Met à jour une licence globale de liste d'utilisateurs.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

UserListService

Service permettant de gérer les ressources UserList.

CreateUserList

rpc CreateUserList(CreateUserListRequest) returns (UserList)

Crée une UserList.

En-têtes d'autorisation :

Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :

  • login-account : (facultatif) nom de ressource du compte dont le compte Google des identifiants est un utilisateur. Si ce champ n'est pas défini, la valeur par défaut est le compte de la demande. Format : accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account : (facultatif) nom de ressource du compte avec un lien produit établi vers login-account. Format : accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc DeleteUserList(DeleteUserListRequest) returns (Empty)

Supprime une UserList.

En-têtes d'autorisation :

Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :

  • login-account : (facultatif) nom de ressource du compte dont le compte Google des identifiants est un utilisateur. Si ce champ n'est pas défini, la valeur par défaut est le compte de la demande. Format : accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account : (facultatif) nom de ressource du compte avec un lien produit établi vers login-account. Format : accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc GetUserList(GetUserListRequest) returns (UserList)

Obtient une UserList.

En-têtes d'autorisation :

Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :

  • login-account : (facultatif) nom de ressource du compte dont le compte Google des identifiants est un utilisateur. Si ce champ n'est pas défini, la valeur par défaut est le compte de la demande. Format : accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account : (facultatif) nom de ressource du compte avec un lien produit établi vers login-account. Format : accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc ListUserLists(ListUserListsRequest) returns (ListUserListsResponse)

Liste les listes d'utilisateurs.

En-têtes d'autorisation :

Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :

  • login-account : (facultatif) nom de ressource du compte dont le compte Google des identifiants est un utilisateur. Si ce champ n'est pas défini, la valeur par défaut est le compte de la demande. Format : accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account : (facultatif) nom de ressource du compte avec un lien produit établi vers login-account. Format : accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc UpdateUserList(UpdateUserListRequest) returns (UserList)

Met à jour une liste d'utilisateurs.

En-têtes d'autorisation :

Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :

  • login-account : (facultatif) nom de ressource du compte dont le compte Google des identifiants est un utilisateur. Si ce champ n'est pas défini, la valeur par défaut est le compte de la demande. Format : accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account : (facultatif) nom de ressource du compte avec un lien produit établi vers login-account. Format : accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
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'accès au 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.

Âge

Tranches d'âge démographiques

Enums
AGE_RANGE_UNSPECIFIED Non spécifié.
AGE_RANGE_UNKNOWN Inconnu.
AGE_RANGE_18_24 Avoir entre 18 et 24 ans
AGE_RANGE_25_34 Entre 25 et 34 ans
AGE_RANGE_35_44 Entre 35 et 44 ans
AGE_RANGE_45_54 Entre 45 et 54 ans
AGE_RANGE_55_64 Entre 55 et 64 ans
AGE_RANGE_65_UP 65 ans et plus

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)

Cette fonctionnalité n'est disponible que pour les partenaires de données.

mobile_data

MobileData

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

user_id_data

UserIdData

Données liées aux identifiants uniques d'un utilisateur, tels que définis par l'annonceur.

ppid_data

PpidData

Données liées aux identifiants fournis par l'éditeur.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

AwsWrappedKeyInfo

Clé de chiffrement des données encapsulée par une clé AWS KMS.

Champs
key_type

KeyType

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

role_arn

string

Obligatoire. Nom de ressource Amazon du rôle IAM à assumer pour l'accès au déchiffrement KMS. Doit être au format arn:{partition}:iam::{account_id}:role/{role_name}

kek_uri

string

Obligatoire. URI de la clé AWS KMS utilisée pour déchiffrer la DEK. Doit être au format arn:{partition}:kms:{region}:{account_id}:key/{key_id} ou aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id}

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

Référence

Critères de référence par rapport auxquels les insights sont comparés.

Champs
Champ d'union baseline. Emplacement de référence auquel les insights sont comparés. baseline ne peut être qu'un des éléments suivants :
baseline_location

Location

Emplacement de référence de la demande. L'emplacement de référence est une liste OR des régions demandées.

location_auto_detection_enabled

bool

Si la valeur est définie sur "true", le service tente de détecter automatiquement le lieu de référence pour les insights.

Emplacement

Emplacement de référence de la demande. La zone géographique de référence figure dans la liste OR des codes régionaux ISO 3166-1 alpha-2 des régions demandées.

Champs
region_codes[]

string

Liste des codes régionaux ISO 3166-1 alpha-2.

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 que vous importez.

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 consent à ce que ses données soient utilisées pour les annonces.

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.

ContactIdInfo

Informations supplémentaires lorsque CONTACT_ID fait partie des upload_key_types.

Champs
match_rate_percentage

int32

Uniquement en sortie. Taux de correspondance pour les listes d'utilisateurs pour le ciblage par liste de clients.

data_source_type

DataSourceType

Facultatif. Immuable. Source des données importées

CreatePartnerLinkRequest

Demande de création d'une ressource PartnerLink. Renvoie un PartnerLink.

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

string

Obligatoire. Parent qui possède cette collection de liens partenaires. Format : accountTypes/{account_type}/accounts/{account}

CreateUserListDirectLicenseRequest

Demande de création d'une ressource UserListDirectLicense.

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

string

Obligatoire. Compte propriétaire de la liste d'utilisateurs pour laquelle une licence est accordée. Doit être au format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

user_list_direct_license

UserListDirectLicense

Obligatoire. Licence directe de la liste d'utilisateurs à créer.

CreateUserListGlobalLicenseRequest

Demande de création d'une ressource UserListGlobalLicense.

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

string

Obligatoire. Compte propriétaire de la liste d'utilisateurs pour laquelle une licence est accordée. Doit être au format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

user_list_global_license

UserListGlobalLicense

Obligatoire. Licence globale de liste d'utilisateurs à créer.

CreateUserListRequest

Message de requête pour CreateUserList.

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

string

Obligatoire. Compte parent dans lequel cette liste d'utilisateurs sera créée. Format : accountTypes/{account_type}/accounts/{account}

user_list

UserList

Obligatoire. Liste d'utilisateurs à créer.

validate_only

bool

Facultatif. Si la valeur est "true", la requête est validée, mais pas exécuté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 Unspecified CustomerValueBucket. 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.

DataSourceType

Indique la source des données importées.

Enums
DATA_SOURCE_TYPE_UNSPECIFIED Non spécifié.
DATA_SOURCE_TYPE_FIRST_PARTY Les données importées sont des données first party.
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU Les données importées proviennent d'un organisme de crédit tiers.
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE Les données importées proviennent d'un fichier d'électeurs tiers.
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA Les données importées sont des données de partenaires tiers.

DeletePartnerLinkRequest

Demande de suppression d'une ressource PartnerLink. Renvoie un google.protobuf.Empty.

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

string

Obligatoire. Nom de ressource du lien partenaire à supprimer. Format : accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

DeleteUserListRequest

Message de requête pour DeleteUserList.

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

string

Obligatoire. Nom de la liste d'utilisateurs à supprimer. Format : accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

validate_only

bool

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

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'accepte pas la mise en correspondance des adresses IP pour les utilisateurs finaux situés dans l'Espace économique européen (EEE), au Royaume-Uni (UK) ou en 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.

aws_wrapped_key_info

AwsWrappedKeyInfo

Informations sur la clé encapsulée Amazon Web Services.

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.

ErrorReason

Motifs d'erreur pour l'API Data Manager. REMARQUE : Cette énumération n'est pas figée et de nouvelles valeurs pourront être ajoutées à l'avenir.

Enums
ERROR_REASON_UNSPECIFIED N'utilisez pas cette valeur par défaut.
INTERNAL_ERROR Une erreur interne s'est produite.
DEADLINE_EXCEEDED La requête a mis trop de temps à répondre.
RESOURCE_EXHAUSTED Trop de requêtes.
NOT_FOUND Ressource introuvable.
PERMISSION_DENIED L'utilisateur ne dispose pas des autorisations nécessaires ou la ressource est introuvable.
INVALID_ARGUMENT Un problème est survenu concernant cette demande.
REQUIRED_FIELD_MISSING Un champ obligatoire n'est pas renseigné.
INVALID_FORMAT Le format n'est pas valide.
INVALID_HEX_ENCODING Le format de la valeur encodée en HEX est incorrect.
INVALID_BASE64_ENCODING Le format de la valeur encodée en base64 est incorrect.
INVALID_SHA256_FORMAT Le format de la valeur encodée en SHA256 est incorrect.
INVALID_POSTAL_CODE Le code postal n'est pas valide.
INVALID_COUNTRY_CODE Le code pays n'est pas valide.
INVALID_ENUM_VALUE La valeur enum ne peut pas être utilisée.
INVALID_USER_LIST_TYPE Le type de la liste d'utilisateurs n'est pas applicable à cette demande.
INVALID_AUDIENCE_MEMBER Ce membre de l'audience n'est pas valide.
TOO_MANY_AUDIENCE_MEMBERS Le nombre maximal de membres d'audience autorisé par requête est de 10 000.
TOO_MANY_USER_IDENTIFIERS Le nombre maximal d'identifiants utilisateur autorisé par membre de l'audience est de 10.
TOO_MANY_DESTINATIONS Le nombre maximal de destinations autorisées par demande est de 10.
INVALID_DESTINATION Cette destination n'est pas valide.
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED Le partenaire de données n'a pas accès à la liste des utilisateurs propriétaires du compte d'exploitation.
INVALID_MOBILE_ID_FORMAT Le format de l'ID mobile n'est pas valide.
INVALID_USER_LIST_ID La liste d'utilisateurs n'est pas valide.
MULTIPLE_DATA_TYPES_NOT_ALLOWED Vous ne pouvez pas ingérer plusieurs types de données dans une même requête.
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER Les configurations de destination contenant un compte de connexion DataPartner doivent avoir le même compte de connexion dans toutes les configurations de destination.
TERMS_AND_CONDITIONS_NOT_SIGNED Les conditions d'utilisation requises n'ont pas été acceptées.
INVALID_NUMBER_FORMAT Format de nombre non valide.
INVALID_CONVERSION_ACTION_ID L'ID de l'action de conversion n'est pas valide.
INVALID_CONVERSION_ACTION_TYPE Le type d'action de conversion n'est pas valide.
INVALID_CURRENCY_CODE Le code de devise n'est pas accepté.
INVALID_EVENT Cet événement n'est pas valide.
TOO_MANY_EVENTS Le nombre maximal d'événements autorisés par requête est de 10 000.
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Le suivi avancé des conversions pour les prospects n'est pas activé dans le compte de destination.
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS Impossible d'utiliser le suivi avancé des conversions pour le compte de destination en raison des règles Google sur les données client. Contactez votre représentant Google.
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Le compte de destination n'a pas accepté les conditions d'utilisation du suivi avancé des conversions.
DUPLICATE_DESTINATION_REFERENCE Au moins deux destinations de la demande ont la même référence.
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER Compte d'exploitation non compatible pour l'autorisation des partenaires de données.
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER Compte associé non accepté pour l'autorisation du partenaire pour les données.
NO_IDENTIFIERS_PROVIDED Les données d'événements ne contiennent aucun identifiant utilisateur ni aucun identifiant publicitaire.
INVALID_PROPERTY_TYPE Le type de propriété n'est pas accepté.
INVALID_STREAM_TYPE Le type de flux n'est pas accepté.
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT L'association de compte n'est possible que si le compte de connexion est un compte DATA_PARTNER.
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH Le compte de connexion doit être le même que le compte d'exploitation pour le cas d'utilisation donné.
EVENT_TIME_INVALID L'événement ne s'est pas produit dans le délai acceptable.
RESERVED_NAME_USED Le paramètre utilise un nom réservé.
INVALID_EVENT_NAME Le nom de l'événement n'est pas accepté.
NOT_ALLOWLISTED Le compte n'est pas autorisé à utiliser la fonctionnalité indiquée.
INVALID_REQUEST_ID L'ID de demande utilisé pour récupérer l'état d'une demande n'est pas valide. L'état ne peut être récupéré que pour les requêtes qui aboutissent et qui ne comportent pas validate_only=true.
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT Un événement comportait au moins deux destinations Google Analytics.
FIELD_VALUE_TOO_LONG La valeur du champ est trop longue.
TOO_MANY_ELEMENTS La requête contient trop d'éléments dans une liste.
ALREADY_EXISTS La ressource existe déjà.
IMMUTABLE_FIELD_FOR_UPDATE Tentative de définition d'un champ immuable pour une demande de mise à jour.
INVALID_RESOURCE_NAME Le nom de la ressource n'est pas valide.
INVALID_FILTER Le filtre de requête n'est pas valide.
INVALID_UPDATE_MASK Le masque de mise à jour n'est pas valide.
INVALID_PAGE_TOKEN Le jeton de page n'est pas valide.
CANNOT_UPDATE_DISABLED_LICENSE Vous ne pouvez pas mettre à jour une licence qui a été désactivée.
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST Les listes d'utilisateurs sensibles ne peuvent pas être concédées sous licence à ce client.
INSUFFICIENT_COST Le coût est trop faible pour cette licence.
CANNOT_DISABLE_LICENSE La licence de revendeur ne peut pas être désactivée, car elle est en cours d'utilisation.
INVALID_CLIENT_ACCOUNT_ID Numéro de compte client incorrect.
PRICING_ONLY_ZERO_COST_ALLOWED Un coût non nul n'est pas autorisé pour ce compte client.
PRICE_TOO_HIGH Le coût est trop élevé pour cette licence.
CUSTOMER_NOT_ALLOWED_TO_CREATE_LICENSE Le client n'est pas autorisé à créer une licence.
INVALID_PRICING_END_DATE La date de fin de la tarification n'est pas valide pour cette licence.
CANNOT_LICENSE_LOGICAL_LIST_WITH_LICENSED_OR_SHARED_SEGMENT Il est impossible d'autoriser une liste d'utilisateurs logique avec un segment partagé ou autorisé.
MISMATCHED_ACCOUNT_TYPE Le type de compte client dans la demande ne correspond pas au type de compte réel du client.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_LICENSE_TYPE Le type de licence ne permet pas de partager les coûts des contenus multimédias.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_CLIENT_CUSTOMER Le type de client n'est pas compatible avec le coût de partage média.
INVALID_MEDIA_SHARE_COST Coût de part média non valide.
INVALID_COST_TYPE Type de coût non valide.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_NON_COMMERCE_USER_LIST Le type UserList n'est pas compatible avec le coût de partage de contenu multimédia.
MAX_COST_NOT_ALLOWED Le coût maximal n'est autorisé que pour le cost_type MEDIA_SHARE.
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED L'audience commerciale ne peut être concédée sous licence que directement.
INVALID_DESCRIPTION La description n'est pas valide.
INVALID_DISPLAY_NAME Le nom à afficher n'est pas valide.
DISPLAY_NAME_ALREADY_USED Le nom à afficher est déjà utilisé pour une autre liste d'utilisateurs du compte.
OWNERSHIP_REQUIRED_FOR_UPDATE Vous devez être propriétaire pour modifier la liste des utilisateurs.
USER_LIST_MUTATION_NOT_SUPPORTED Le type de liste d'utilisateurs est en lecture seule et n'est pas compatible avec la mutation.
SENSITIVE_USER_LIST_IMMUTABLE Les utilisateurs externes ne peuvent pas modifier une liste d'utilisateurs refusée pour des raisons juridiques ou de confidentialité.
BILLABLE_RECORD_COUNT_IMMUTABLE Une fois défini, le champ "Enregistrement facturable" de la liste d'utilisateurs pour le remarketing ne peut plus être modifié.
USER_LIST_NAME_RESERVED Le nom de la liste d'utilisateurs est réservé aux listes système.
ADVERTISER_NOT_ALLOWLISTED_FOR_UPLOADED_DATA L'annonceur doit être ajouté à la liste d'autorisation pour pouvoir utiliser les listes de remarketing créées à partir des données qu'il a importées.
UNSUPPORTED_PARTNER_AUDIENCE_SOURCE La source d'audience partenaire n'est pas compatible avec le type de liste d'utilisateurs.
COMMERCE_PARTNER_NOT_ALLOWED La définition du champ commerce_partner n'est acceptée que si partner_audience_source est COMMERCE_AUDIENCE.
UNSUPPORTED_PARTNER_AUDIENCE_INFO Le champ partner_audience_info n'est pas compatible avec le type de liste d'utilisateurs.
PARTNER_MATCH_FOR_MANAGER_ACCOUNT_DISALLOWED Les comptes administrateur ne peuvent pas créer de listes d'utilisateurs pour le ciblage par liste de partenaires.
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA Le partenaire de données ne figure pas dans la liste d'autorisation pour THIRD_PARTY_PARTNER_DATA.
ADVERTISER_TOS_NOT_ACCEPTED L'annonceur n'a pas accepté les conditions d'utilisation du partenaire.
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA L'annonceur ne figure pas sur la liste autorisée pour THIRD_PARTY_PARTNER_DATA.
USER_LIST_TYPE_NOT_SUPPORTED_FOR_ACCOUNT Ce type de liste d'utilisateurs n'est pas compatible avec ce compte.
INVALID_COMMERCE_PARTNER Le champ commerce_partner n'est pas valide.
CUSTOMER_NOT_ALLOWLISTED_FOR_COMMERCE_AUDIENCE Le fournisseur de données ne figure pas sur la liste autorisée à créer des audiences commerciales.
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES Les types de clés d'importation de listes d'utilisateurs ne sont pas acceptés.
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG La configuration des informations de la liste d'utilisateurs ingérée n'est pas acceptée.
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE Les types de comptes ne sont pas compatibles avec le type de liste d'utilisateurs.

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

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.

event_name

string

Facultatif. Nom de l'événement. Obligatoire pour les événements GA4.

client_id

string

Facultatif. Identifiant unique de l'instance utilisateur d'un client Web pour ce flux Web GA4.

user_id

string

Facultatif. Identifiant unique d'un utilisateur, tel que défini par l'annonceur.

additional_event_parameters[]

EventParameter

Facultatif. Un bucket de paramètres d'événement à inclure dans l'événement qui n'ont pas déjà été spécifiés à l'aide d'autres champs structurés.

conversion_value

double

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

EventParameter

Paramètre d'événement pour les événements GA4.

Champs
parameter_name

string

Obligatoire. Nom du paramètre à utiliser.

value

string

Obligatoire. Représentation sous forme de chaîne de la valeur du paramètre à définir.

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} ou gcp-kms://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

Sexe

Type de genre démographique (par exemple, "féminin").

Enums
GENDER_UNSPECIFIED Non spécifié.
GENDER_UNKNOWN Inconnu.
GENDER_MALE Homme.
GENDER_FEMALE Femme.

GetUserListDirectLicenseRequest

Requête permettant d'obtenir une ressource UserListDirectLicense.

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

string

Obligatoire. Nom de ressource de la licence directe de la liste d'utilisateurs.

GetUserListGlobalLicenseRequest

Requête permettant d'obtenir une ressource UserListGlobalLicense.

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

string

Obligatoire. Nom de ressource de la licence globale de la liste d'utilisateurs.

GetUserListRequest

Message de requête pour GetUserList.

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

string

Obligatoire. Nom de ressource de la UserList à récupérer. Format : accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

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 :
Champs
destinations[]

Destination

Obligatoire. Liste des destinations vers lesquelles envoyer 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 généré automatiquement pour la demande.

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 :
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 ne pouvez envoyer que 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 généré automatiquement pour la demande.

IngestedUserListInfo

Représente une liste d'utilisateurs renseignée à partir des données fournies par l'utilisateur.

Champs
upload_key_types[]

UploadKeyType

Obligatoire. Immuable. Types de clés d'importation de cette liste d'utilisateurs.

contact_id_info

ContactIdInfo

Facultatif. Informations supplémentaires lorsque CONTACT_ID fait partie des upload_key_types.

mobile_id_info

MobileIdInfo

Facultatif. Informations supplémentaires lorsque MOBILE_ID fait partie des upload_key_types.

user_id_info

UserIdInfo

Facultatif. Informations supplémentaires lorsque USER_ID fait partie des upload_key_types.

pair_id_info

PairIdInfo

Facultatif. Informations supplémentaires lorsque PAIR_ID fait partie des upload_key_types.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

pseudonymous_id_info

PseudonymousIdInfo

Facultatif. Les informations supplémentaires pour PSEUDONYMOUS_ID font partie des upload_key_types.

partner_audience_info

PartnerAudienceInfo

Facultatif. Informations supplémentaires pour les audiences partenaires.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

UploadKeyType

Énumération contenant les types de clés d'importation possibles d'une liste d'utilisateurs.

Enums
UPLOAD_KEY_TYPE_UNSPECIFIED Non spécifié.
CONTACT_ID Informations sur les clients, telles que leur adresse e-mail, leur numéro de téléphone ou leur adresse physique.
MOBILE_ID Identifiants publicitaires pour mobile.
USER_ID ID utilisateur fournis par des tiers.
PAIR_ID ID de rapprochement de l'identité des annonceurs et des éditeurs.
PSEUDONYMOUS_ID ID de plate-forme de gestion des données : - ID utilisateur Google ; - ID fourni par le partenaire ; - ID fourni par l'éditeur ; - IDFA iOS ; - Identifiant publicitaire Android ; - ID Roku ; - ID Amazon Fire TV ; - ID Xbox ou Microsoft

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

item_id

string

Facultatif. Identifiant unique permettant de faire référence à l'élément.

additional_item_parameters[]

ItemParameter

Facultatif. Un bucket de paramètres d'événement liés à un élément à inclure dans l'événement qui n'ont pas déjà été spécifiés à l'aide d'autres champs structurés.

ItemParameter

Un bucket de paramètres d'événement liés à un élément à inclure dans l'événement qui n'ont pas déjà été spécifiés à l'aide d'autres champs structurés.

Champs
parameter_name

string

Obligatoire. Nom du paramètre à utiliser.

value

string

Obligatoire. Représentation sous forme de chaîne de la valeur du paramètre à définir.

ListUserListDirectLicensesRequest

Demande de liste de toutes les ressources UserListDirectLicense pour un compte donné.

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

string

Obligatoire. Compte dont les licences sont interrogées. Doit être au format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

filter

string

Facultatif. Filtres à appliquer à la requête de liste. Tous les champs doivent se trouver à gauche de chaque condition (par exemple, user_list_id = 123).

Opérations compatibles :

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Champs non compatibles :

  • name (utilisez plutôt la méthode "get")
  • historical_pricings et tous ses sous-champs
  • pricing.start_time
  • pricing.end_time
page_size

int32

Facultatif. Nombre maximal de licences à renvoyer par page. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 licences au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListUserListDirectLicense précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListUserListDirectLicense doivent correspondre à l'appel ayant fourni le jeton de page.

ListUserListDirectLicensesResponse

Réponse de ListUserListDirectLicensesRequest.

Champs
user_list_direct_licenses[]

UserListDirectLicense

Licences pour la liste d'utilisateurs spécifiée dans la requête.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListUserListGlobalLicenseCustomerInfosRequest

Demande de liste de toutes les ressources UserListGlobalLicenseCustomerInfo pour une licence globale de liste d'utilisateurs donnée.

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

string

Obligatoire. Licence mondiale dont les informations client sont demandées. Format requis : accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. Pour lister toutes les informations client sur les licences mondiales d 'un compte, remplacez l'ID de licence mondiale de la liste des utilisateurs par un tiret (par exemple, accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).

filter

string

Facultatif. Filtres à appliquer à la requête de liste. Tous les champs doivent se trouver à gauche de chaque condition (par exemple, user_list_id = 123).

Opérations compatibles :

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Champs non compatibles :

  • name (utilisez plutôt la méthode "get")
  • historical_pricings et tous ses sous-champs
  • pricing.start_time
  • pricing.end_time
page_size

int32

Facultatif. Nombre maximal de licences à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 licences au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListUserListDirectLicense précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListUserListDirectLicense doivent correspondre à l'appel ayant fourni le jeton de page.

ListUserListGlobalLicenseCustomerInfosResponse

Réponse à la requête [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].

Champs
user_list_global_license_customer_infos[]

UserListGlobalLicenseCustomerInfo

Informations sur le client pour la licence donnée dans la requête.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListUserListGlobalLicensesRequest

Demande de liste de toutes les ressources UserListGlobalLicense pour un compte donné.

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

string

Obligatoire. Compte dont les licences sont interrogées. Doit être au format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

filter

string

Facultatif. Filtres à appliquer à la requête de liste. Tous les champs doivent se trouver à gauche de chaque condition (par exemple, user_list_id = 123).

Opérations compatibles :

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Champs non compatibles :

  • name (utilisez plutôt la méthode "get")
  • historical_pricings et tous ses sous-champs
  • pricing.start_time
  • pricing.end_time
page_size

int32

Facultatif. Nombre maximal de licences à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 licences au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListUserListGlobalLicense précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListUserListDirectLicense doivent correspondre à l'appel ayant fourni le jeton de page.

ListUserListGlobalLicensesResponse

Réponse de ListUserListGlobalLicensesRequest.

Champs
user_list_global_licenses[]

UserListGlobalLicense

Licences pour la liste d'utilisateurs spécifiée dans la requête.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListUserListsRequest

Message de requête pour ListUserLists.

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

string

Obligatoire. Compte parent qui possède cette collection de listes d'utilisateurs. Format : accountTypes/{account_type}/accounts/{account}

page_size

int32

Facultatif. Nombre maximal de listes d'utilisateurs à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 listes d'utilisateurs au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListUserLists précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListUserLists doivent correspondre à l'appel ayant fourni le jeton de page.

filter

string

Facultatif. Une chaîne de filtre. Tous les champs doivent se trouver à gauche de chaque condition (par exemple, display_name = "list 1").

Opérations compatibles :

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=
  • : (a)

Champs acceptés :

  • id
  • display_name
  • description
  • membership_status
  • integration_code
  • access_reason
  • ingested_user_list_info.upload_key_types

ListUserListsResponse

Message de réponse pour ListUserLists.

Champs
user_lists[]

UserList

Liste des utilisateurs du compte spécifié.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

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 La plage du taux de correspondance est comprise entre 61 % et 70 % (dans l'intervalle [61, 71)).
MATCH_RATE_RANGE_71_TO_80 La plage du taux de correspondance est comprise 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 identifiant 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.

MobileIdInfo

Informations supplémentaires lorsque MOBILE_ID fait partie des upload_key_types.

Champs
data_source_type

DataSourceType

Facultatif. Immuable. Source des données importées.

key_space

KeySpace

Obligatoire. Immuable. Espace de clés des ID mobiles.

app_id

string

Obligatoire. Immuable. Chaîne qui identifie de manière unique une application mobile à partir de laquelle les données ont été collectées.

KeySpace

Espace de clés pour l'identité mobile.

Enums
KEY_SPACE_UNSPECIFIED Non spécifié.
IOS Espace de clés iOS.
ANDROID Espace de clés Android.

PairData

ID PAIR pour l'audience. Veuillez indiquer au moins un ID PAIR.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs
pair_ids[]

string

Obligatoire. Données permettant d'identifier personnellement l'utilisateur fournies par la cleanroom, hachées avec SHA256 et chiffrées avec un chiffrement EC commutatif à 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.

PairIdInfo

Informations supplémentaires lorsque PAIR_ID fait partie des upload_key_types.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs
match_rate_percentage

int32

Uniquement en sortie. Ce champ indique le pourcentage de membres de cette liste d'utilisateurs correspondant aux données first party de l'éditeur. Doit être compris entre 0 et 100 (inclus).

advertiser_identifier_count

int64

Uniquement en sortie. Nombre d'enregistrements de données first party de l'annonceur importés chez un fournisseur de data clean room. Cela n'indique pas la taille d'une liste d'utilisateurs PAIR.

publisher_id

int64

Obligatoire. Immuable. Identifie l'éditeur avec lequel la liste d'utilisateurs Publisher Advertiser Identity Reconciliation est réconciliée. Ce champ est fourni par le fournisseur de salle blanche et n'est unique que dans le champ d'application de cette salle blanche. Cette chaîne ne peut pas être utilisée comme identifiant global dans plusieurs cleanrooms.

publisher_name

string

Facultatif. Nom descriptif de l'éditeur à afficher dans l'UI pour une meilleure expérience de ciblage.

clean_room_identifier

string

Obligatoire. Immuable. Identifie une relation unique entre un annonceur et un éditeur avec un ou plusieurs fournisseurs de salles blanches.

PartnerAudienceInfo

Informations supplémentaires pour les audiences partenaires.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs
partner_audience_source

PartnerAudienceSource

Obligatoire. Immuable. Source de l'audience partenaire.

commerce_partner

string

Facultatif. Nom du partenaire commercial. Uniquement autorisé si partner_audience_source est défini sur COMMERCE_AUDIENCE.

PartnerAudienceSource

Source d'audience partenaire.

Enums
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED Non spécifié.
COMMERCE_AUDIENCE La source d'audience partenaire est une audience pour le commerce.
LINEAR_TV_AUDIENCE La source d'audience partenaire est l'audience de la TV linéaire.
AGENCY_PROVIDER_AUDIENCE La source d'audience partenaire est une audience d'agence/fournisseur.

PpidData

Données des identifiants fournis par l'éditeur contenant les PPID. Veuillez indiquer au moins un PPID.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs
ppids[]

string

Obligatoire. Liste des identifiants fournis par l'éditeur pour un utilisateur.

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 elle est incorrecte ou 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_AWS_AUTH_FAILED Le système n'a pas réussi à s'authentifier auprès d'AWS.
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 elle est incorrecte ou 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.
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED Le système n'a pas réussi à s'authentifier auprès d'AWS.

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 les comptes et les 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.
GOOGLE_ANALYTICS_PROPERTY Google Analytics.

PseudonymousIdInfo

Informations supplémentaires lorsque PSEUDONYMOUS_ID fait partie des upload_key_types.

Champs
sync_status

SyncStatus

Uniquement en sortie. État de la synchronisation de la liste d'utilisateurs.

billable_record_count

int64

Facultatif. Immuable. Nombre d'enregistrements facturables (par exemple, importés ou mis en correspondance).

SyncStatus

État de la synchronisation de la liste d'utilisateurs.

Enums
SYNC_STATUS_UNSPECIFIED Non spécifié.
CREATED La liste d'utilisateurs a été créée en tant qu'espace réservé. Le contenu et/ou les métadonnées de la liste sont toujours en cours de synchronisation. La liste d'utilisateurs n'est pas prête à être utilisée.
READY_FOR_USE La liste des utilisateurs est prête à être utilisée. Le contenu et les cookies ont été correctement synchronisés.
FAILED Une erreur s'est produite lors de la synchronisation du contenu et/ou des métadonnées de la liste des utilisateurs. Impossible d'utiliser la liste des utilisateurs.

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

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.

user_id_data_ingestion_status

IngestUserIdDataStatus

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

ppid_data_ingestion_status

IngestPpidDataStatus

État de l'ingestion des données PPID 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 requête, 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 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 requête, 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.

IngestPpidDataStatus

État de l'ingestion des données PPID 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 requête, qu'ils aient été ingérés ou non.

ppid_count

int64

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

IngestUserDataStatus

État de l'ingestion des données utilisateur 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 requête, 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.

IngestUserIdDataStatus

État de l'ingestion des données d'ID utilisateur 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 requête, qu'ils aient été ingérés ou non.

user_id_count

int64

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

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.

user_id_data_removal_status

RemoveUserIdDataStatus

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

ppid_data_removal_status

RemovePpidDataStatus

État de la suppression des données PPID 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 demande, 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 requête, 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 demande, 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.

RemovePpidDataStatus

État de la suppression des données PPID 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 demande, qu'ils aient été supprimés ou non.

ppid_count

int64

Nombre total de ppids envoyés dans la demande de suppression. Inclut tous les ppids de la demande, 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 demande, 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.

RemoveUserIdDataStatus

État de la suppression des données d'ID 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 demande, qu'ils aient été supprimés ou non.

user_id_count

int64

Nombre total d'ID utilisateur envoyés dans la demande de suppression. Inclut tous les ID utilisateur de la requête, 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.

RetrieveInsightsRequest

Message de requête pour DM API MarketingDataInsightsService.RetrieveInsights

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

string

Obligatoire. Compte parent propriétaire de la liste d'utilisateurs. Format : accountTypes/{account_type}/accounts/{account}

baseline

Baseline

Obligatoire. Valeur de référence pour les insights demandés.

user_list_id

string

Obligatoire. ID de la liste d'utilisateurs pour laquelle des insights sont demandés.

RetrieveInsightsResponse

Message de réponse pour DM API MarketingDataInsightsService.RetrieveInsights

Champs
marketing_data_insights[]

MarketingDataInsight

Contient les insights pour les données marketing.

MarketingDataInsight

Insights pour les données marketing

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs
dimension

AudienceInsightsDimension

Dimension à laquelle appartient l'insight.

attributes[]

MarketingDataInsightsAttribute

Insights pour les valeurs d'une dimension donnée.

AudienceInsightsDimension

Dimensions possibles à utiliser pour générer des insights.

Enums
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Non spécifié.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN La valeur est inconnue dans cette version.
AFFINITY_USER_INTEREST Un Affinity UserInterest.
IN_MARKET_USER_INTEREST Un UserInterest sur le marché.
AGE_RANGE Tranche d'âge.
GENDER Genre

MarketingDataInsightsAttribute

Insights pour une collection d'attributs associés de la même dimension.

Champs
user_interest_id

int64

ID du centre d'intérêt de l'utilisateur.

lift

float

Mesure de l'impact de l'audience pour la valeur de l'attribut par rapport à la référence. Plage [0-1].

age_range

AgeRange

Tranche d'âge de l'audience pour laquelle l'impact est fourni.

gender

Gender

Genre de l'audience pour laquelle l'impact est fourni.

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 :
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 à celui des destinations dans la demande d'origine.

SearchPartnerLinksRequest

Demande de recherche de ressources PartnerLink. Renvoie un SearchPartnerLinksResponse.

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

string

Obligatoire. Compte à utiliser pour rechercher des liens de partenaire. Si aucun filter n'est spécifié, tous les liens partenaires pour lesquels ce compte est owning_account ou partner_account sont renvoyés.

Format : accountTypes/{account_type}/accounts/{account}

page_size

int32

Nombre maximal de liens partenaires à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 10 liens partenaires au maximum sont renvoyés. La valeur maximale est 100. Les valeurs supérieures sont réduites à 100.

page_token

string

Jeton de page reçu d'un appel SearchPartnerLinks précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à SearchPartnerLinks doivent correspondre à l'appel ayant fourni le jeton de page.

filter

string

Facultatif. Une chaîne de filtre. Tous les champs doivent se trouver à gauche de chaque condition (par exemple, partner_link_id = 123456789).

Opérations compatibles :

  • AND
  • =
  • !=

Champs acceptés :

  • partner_link_id
  • owning_account.account_type
  • owning_account.account_id
  • partner_account.account_type
  • partner_account.account_id

Exemple : owning_account.account_type = "GOOGLE_ADS" OR partner_account.account_id = 987654321

SearchPartnerLinksResponse

Réponse de SearchPartnerLinksRequest.

Champs
next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

SizeInfo

Nombre estimé de membres de cette liste d'utilisateurs dans différents réseaux cibles.

Champs
display_network_members_count

int64

Uniquement en sortie. Nombre estimé de membres de cette liste d'utilisateurs sur le Réseau Display de Google.

search_network_members_count

int64

Uniquement en sortie. Nombre estimé de membres de cette liste d'utilisateurs dans le domaine google.com. Voici les membres disponibles pour le ciblage dans les campagnes sur le Réseau de Recherche.

TargetNetworkInfo

Informations sur l'éligibilité pour différents réseaux cibles.

Champs
eligible_for_display

bool

Uniquement en sortie. Indique que cette liste d'utilisateurs est éligible au Réseau Display de Google.

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

UpdateUserListDirectLicenseRequest

Requête de mise à jour d'une ressource UserListDirectLicense.

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

UserListDirectLicense

Obligatoire. Le champ name des licences permet d'identifier la licence à mettre à jour.

update_mask

FieldMask

Facultatif. Liste des champs à mettre à jour. Le caractère spécial * n'est pas accepté. Une erreur INVALID_UPDATE_MASK sera générée s'il est utilisé.

UpdateUserListGlobalLicenseRequest

Requête de mise à jour d'une ressource UserListGlobalLicense.

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

UserListGlobalLicense

Obligatoire. Le champ name des licences permet d'identifier la licence à mettre à jour.

update_mask

FieldMask

Facultatif. Liste des champs à mettre à jour. Le caractère spécial * n'est pas accepté. Une erreur INVALID_UPDATE_MASK sera générée s'il est utilisé.

UpdateUserListRequest

Message de requête pour UpdateUserList.

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

UserList

Obligatoire. Liste d'utilisateurs à mettre à jour.

Le champ name de la liste d'utilisateurs permet d'identifier la liste d'utilisateurs à mettre à jour. Format : accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

update_mask

FieldMask

Facultatif. Liste des champs à mettre à jour.

validate_only

bool

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

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.

UserIdData

Données d'ID utilisateur contenant l'ID utilisateur.

Champs
user_id

string

Obligatoire. Identifiant unique d'un utilisateur, tel que défini par l'annonceur.

UserIdInfo

Informations supplémentaires lorsque USER_ID fait partie des upload_key_types.

Champs
data_source_type

DataSourceType

Facultatif. Immuable. Source des données importées.

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 mis en correspondance simultanément.

UserList

Ressource de liste d'utilisateurs.

Champs
name

string

Identifiant. Nom de ressource de la liste d'utilisateurs. Format : accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

id

int64

Uniquement en sortie. ID unique de la liste d'utilisateurs.

read_only

bool

Uniquement en sortie. Option indiquant si un utilisateur peut modifier une liste.

membership_duration

Duration

Facultatif. Durée pendant laquelle un utilisateur reste dans la liste des utilisateurs. Les durées valides sont des multiples exacts de 24 heures (86 400 secondes). Si vous fournissez une valeur qui n'est pas un multiple exact de 24 heures, une erreur INVALID_ARGUMENT sera générée.

access_reason

AccessReason

Uniquement en sortie. Raison pour laquelle ce compte a été autorisé à accéder à la liste.

size_info

SizeInfo

Uniquement en sortie. Nombre estimé de membres de cette liste d'utilisateurs dans différents réseaux cibles.

target_network_info

TargetNetworkInfo

Facultatif. Informations sur l'éligibilité pour différents réseaux cibles.

display_name

string

Obligatoire. Nom à afficher de la liste des utilisateurs.

description

string

Facultatif. Description de la liste d'utilisateurs.

membership_status

MembershipStatus

Facultatif. État d'appartenance à cette liste d'utilisateurs.

integration_code

string

Facultatif. ID provenant d'un système externe. Les vendeurs de listes d'utilisateurs l'utilisent pour corréler les ID dans leurs systèmes.

closing_reason

ClosingReason

Uniquement en sortie. Motif de la clôture de l'état d'appartenance à cette liste d'utilisateurs.

account_access_status

AccessStatus

Facultatif. Indique si ce partage est toujours activé. Lorsque la liste d'utilisateurs est partagée avec le compte, ce champ est défini sur ENABLED. Le propriétaire de la liste d'utilisateurs peut ensuite décider de révoquer le partage et de le rendre DISABLED.

Champ d'union user_list_info. Informations supplémentaires sur la liste d'utilisateurs. user_list_info ne peut être qu'un des éléments suivants :
ingested_user_list_info

IngestedUserListInfo

Facultatif. Représente une liste d'utilisateurs renseignée par les données ingérées par l'utilisateur.

AccessReason

Énumération décrivant les raisons possibles d'accès.

Enums
ACCESS_REASON_UNSPECIFIED Non spécifié.
OWNED La ressource appartient à l'utilisateur.
SHARED La ressource est partagée avec l'utilisateur.
LICENSED L'utilisateur dispose de la licence pour la ressource.
SUBSCRIBED L'utilisateur s'est abonné à la ressource.
AFFILIATED La ressource est accessible à l'utilisateur.

AccessStatus

Indique si ce client a toujours accès à la liste.

Enums
ACCESS_STATUS_UNSPECIFIED Non spécifié.
ENABLED L'accès est activé.
DISABLED L'accès est désactivé.

ClosingReason

Indique la raison pour laquelle la liste des utilisateurs a été fermée. Cette énumération n'est utilisée que lorsqu'une liste est fermée automatiquement par le système.

Enums
CLOSING_REASON_UNSPECIFIED Non spécifié.
UNUSED La liste d'utilisateurs a été fermée, car elle n'a pas été utilisée récemment pour le ciblage. Pour en savoir plus, consultez https://support.google.com/google-ads/answer/2472738.

MembershipStatus

État de la liste d'utilisateurs.

Enums
MEMBERSHIP_STATUS_UNSPECIFIED Non spécifié.
OPEN Ouverte : la liste d'utilisateurs s'enrichit de membres et peut être ciblée.
CLOSED État "Fermée" : aucun nouveau membre n'est ajouté.

UserListDirectLicense

Une licence directe pour une liste d'utilisateurs.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs
name

string

Identifiant. Nom de ressource de la licence directe de la liste d'utilisateurs.

user_list_display_name

string

Uniquement en sortie. Nom de la liste d'utilisateurs sous licence.

Ce champ est en lecture seule.

client_account_display_name

string

Uniquement en sortie. Nom du client auquel la liste d'utilisateurs est concédée sous licence.

Ce champ est en lecture seule.

pricing

UserListLicensePricing

Facultatif. Tarifs de UserListDirectLicense.

historical_pricings[]

UserListLicensePricing

Uniquement en sortie. Historique des prix de cette licence de liste d'utilisateurs.

Ce champ est en lecture seule.

metrics

UserListLicenseMetrics

Uniquement en sortie. Métriques liées à cette licence

Ce champ est en lecture seule et n'est renseigné que si les dates de début et de fin sont définies dans l'appel ListUserListDirectLicenses.

user_list_id

int64

Immuable. ID de la liste d'utilisateurs pour laquelle une licence est accordée.

client_account_type

UserListLicenseClientAccountType

Immuable. Type de compte client auquel la liste d'utilisateurs est concédée sous licence.

client_account_id

int64

Immuable. ID du compte client auquel la liste d'utilisateurs est concédée sous licence.

status

UserListLicenseStatus

Facultatif. État de UserListDirectLicense : ENABLED ou DISABLED.

UserListGlobalLicense

Une licence globale pour une liste d'utilisateurs.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Champs
name

string

Identifiant. Nom de ressource de la licence globale de la liste d'utilisateurs.

user_list_display_name

string

Uniquement en sortie. Nom de la liste d'utilisateurs sous licence.

Ce champ est en lecture seule.

pricing

UserListLicensePricing

Facultatif. Tarification de UserListGlobalLicense.

historical_pricings[]

UserListLicensePricing

Uniquement en sortie. Historique des prix de cette licence de liste d'utilisateurs.

Ce champ est en lecture seule.

metrics

UserListLicenseMetrics

Uniquement en sortie. Métriques liées à cette licence

Ce champ est en lecture seule et n'est renseigné que si les dates de début et de fin sont définies dans l'appel ListUserListGlobalLicenses.

user_list_id

int64

Immuable. ID de la liste d'utilisateurs pour laquelle une licence est accordée.

license_type

UserListGlobalLicenseType

Immuable. Type de produit du client auquel la liste d'utilisateurs est concédée.

status

UserListLicenseStatus

Facultatif. État de UserListGlobalLicense : ENABLED ou DISABLED.

UserListGlobalLicenseCustomerInfo

Informations sur un client d'une licence globale de liste d'utilisateurs. Il sera automatiquement créé par le système lorsqu'un client achètera une licence mondiale.

Champs
name

string

Identifiant. Nom de ressource du client de licence globale de la liste d'utilisateurs.

user_list_id

int64

Uniquement en sortie. ID de la liste d'utilisateurs pour laquelle une licence est accordée.

user_list_display_name

string

Uniquement en sortie. Nom de la liste d'utilisateurs sous licence.

license_type

UserListGlobalLicenseType

Uniquement en sortie. Type de produit du client auquel la liste d'utilisateurs est concédée.

status

UserListLicenseStatus

Uniquement en sortie. État de UserListDirectLicense : ENABLED ou DISABLED.

pricing

UserListLicensePricing

Uniquement en sortie. Tarifs de UserListDirectLicense.

client_account_type

UserListLicenseClientAccountType

Uniquement en sortie. Type de produit du client auquel la liste d'utilisateurs est concédée.

client_account_id

int64

Uniquement en sortie. ID du compte client auquel la liste d'utilisateurs est concédée sous licence.

client_account_display_name

string

Uniquement en sortie. Nom du client auquel la liste d'utilisateurs est concédée sous licence.

historical_pricings[]

UserListLicensePricing

Uniquement en sortie. Historique des prix de cette licence de liste d'utilisateurs.

metrics

UserListLicenseMetrics

Uniquement en sortie. Métriques liées à cette licence

Ce champ n'est renseigné que si les dates de début et de fin sont définies dans l'appel ListUserListGlobalLicenseCustomerInfos.

UserListGlobalLicenseType

Types de licence globaux pour les listes d'utilisateurs.

Enums
USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED NON SPÉCIFIÉ.
USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER Licence de revendeur.
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE Licence DataMart Sell Side.
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE Licence DataMart Buy Side.

UserListLicenseClientAccountType

Produit possible d'un compte client pour une licence de liste d'utilisateurs.

Enums
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN Inconnu.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS Client Google Ads.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER Partenaire Display & Video 360.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER Annonceur Display & Video 360.

UserListLicenseMetrics

Métriques liées à une licence de liste d'utilisateurs.

Champs
click_count

int64

Uniquement en sortie. Nombre de clics pour la licence de la liste d'utilisateurs.

impression_count

int64

Uniquement en sortie. Nombre d'impressions pour la licence de liste d'utilisateurs.

revenue_usd_micros

int64

Uniquement en sortie. Revenus générés par la licence de la liste d'utilisateurs en millionièmes de dollars américains.

start_date

int64

Uniquement en sortie. Date de début (incluse) des métriques au format AAAAMMJJ. Par exemple, 20260102 représente le 2 janvier 2026. Si end_date est utilisé dans le filtre, start_date est également requis. Si ni start_date ni end_date ne sont inclus dans le filtre, les champs UserListLicenseMetrics ne seront pas renseignés dans la réponse.

end_date

int64

Uniquement en sortie. Date de fin (incluse) des métriques au format AAAAMMJJ. Par exemple, 20260102 représente le 2 janvier 2026. Si start_date est utilisé dans le filtre, end_date est également requis. Si ni start_date ni end_date ne sont inclus dans le filtre, les champs UserListLicenseMetrics ne seront pas renseignés dans la réponse.

UserListLicensePricing

Tarification des licences pour les listes d'utilisateurs.

Champs
pricing_id

int64

Uniquement en sortie. ID de ce prix.

start_time

Timestamp

Uniquement en sortie. Heure de début de la tarification.

end_time

Timestamp

Facultatif. Heure de fin de la tarification.

pricing_active

bool

Uniquement en sortie. Indique si ces tarifs sont actifs.

buyer_approval_state

UserListPricingBuyerApprovalState

Uniquement en sortie. État d'approbation de ce prix par l'acheteur.

Ce champ est en lecture seule.

cost_micros

int64

Facultatif. Coût associé au modèle, en micro-unités (10^-6), dans la devise spécifiée par le champ "currency_code". Par exemple, si currency_code est défini sur USD, la valeur 2000000 correspond à 2 $.

currency_code

string

Facultatif. Devise dans laquelle le coût et max_cost sont spécifiés. Doit être un code de devise à trois lettres défini dans la norme ISO 4217.

cost_type

UserListPricingCostType

Immuable. Type de coût de ce prix.

Ne peut être défini que dans l'opération create. Vous ne pouvez pas modifier une licence existante.

max_cost_micros

int64

Facultatif. CPM maximal pouvant être facturé à une audience commerciale lorsque le type de coût MEDIA_SHARE est utilisé. La valeur est exprimée en micro-unités (10^-6) et dans la devise spécifiée par le champ currency_code. Par exemple, si currency_code est défini sur USD, la valeur 2000000 correspond à 2 $.

Cela n'est pertinent que lorsque cost_type est défini sur MEDIA_SHARE. Si cost_type n'est pas défini sur MEDIA_SHARE et que ce champ est défini, une erreur MAX_COST_NOT_ALLOWED est renvoyée. Si elle n'est pas définie ou si elle est définie sur 0, il n'y a pas de limite.

UserListPricingBuyerApprovalState

État d'approbation de l'acheteur pour le prix de la liste d'utilisateurs.

Enums
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED NON SPÉCIFIÉ.
PENDING Le client de la liste d'utilisateurs n'a pas encore accepté les conditions tarifaires définies par le propriétaire de la liste d'utilisateurs.
APPROVED Le client de la liste d'utilisateurs a accepté les conditions tarifaires définies par le propriétaire de la liste d'utilisateurs.
REJECTED Le client de la liste d'utilisateurs a refusé les conditions tarifaires définies par le propriétaire de la liste d'utilisateurs.

UserListPricingCostType

Type de coût de tarification de la liste d'utilisateurs.

Enums
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED Non spécifié.
CPC Coût par clic.
CPM Coût pour mille impressions.
MEDIA_SHARE Partage de contenus multimédias.

UserListLicenseStatus

État de la licence de la liste d'utilisateurs.

Enums
USER_LIST_LICENSE_STATUS_UNSPECIFIED Inconnu.
USER_LIST_LICENSE_STATUS_ENABLED État actif : la liste d'utilisateurs est toujours sous licence.
USER_LIST_LICENSE_STATUS_DISABLED État inactif : la liste d'utilisateurs n'est plus concédée sous licence.

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.

additional_user_properties[]

UserProperty

Facultatif. Ensemble de propriétés utilisateur supplémentaires pour l'utilisateur associé à cet événement.

UserProperty

Ensemble de propriétés utilisateur supplémentaires pour l'utilisateur associé à cet événement.

Champs
property_name

string

Obligatoire. Nom de la propriété utilisateur à utiliser.

value

string

Obligatoire. Représentation sous forme de chaîne de la valeur de la propriété utilisateur à utiliser.

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.