REST Resource: customers.adsDataLinks

• Ressource: AdsDataLink
  • Représentation JSON
• Entité
  • Représentation JSON
• EntityType
• Platform
• Métrique
• GmpExportScope
• Méthodes

Ressource: AdsDataLink

Représente un lien de données publicitaires.

Représentation JSON
{ "name": string, "linkedEntity": { object (Entity) }, "parentEntity": { object (Entity) }, "childEntities": [ { object (Entity) } ], "platform": enum (Platform), "customerLink": { object (CustomerLink) }, "status": enum (LinkStatus), "createTime": string, "updateTime": string, "vendorClientId": string, "metrics": [ enum (Metric) ], "gmpExportScopes": [ enum (GmpExportScope) ] }

Champs
name	string Nom qui identifie de manière unique une ressource AdsDataLink. Il se présente sous la forme customer/[customerId]/adsDataLinks/[resource_id]. L'ID de ressource est généré par le serveur.
linkedEntity	object (Entity) Entité associée via ce AdsAdsLink.
parentEntity	object (Entity) Entité parente associée, le cas échéant. Si l'entité associée est une campagne Google Ads, ce champ contiendra le client Google Ads auquel la campagne appartient.
childEntities[]	object (Entity) Entités enfants associées, le cas échéant. Si l'entité associée est un client Google Ads qui correspond à une association de gestionnaire de clientèle, les "childEntities" incluront un ensemble complet de clients Google Ads avec des données importées dans Ads Data Hub via ce lien.
platform	enum (Platform) Plate-forme publicitaire associée à l'entité associée.
customerLink	object (CustomerLink) Lien client via lequel les données associées sont accessibles. Seuls le nom, le numéro client et le nom à afficher sont renseignés.
status	enum (LinkStatus) État de l'association des données.
createTime	string (Timestamp format) Heure de création de l'association. Horodatage au format RFC3339 UTC "Zulu" avec une résolution de nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
updateTime	string (Timestamp format) Heure de la dernière mise à jour de l'état de l'association. Horodatage au format RFC3339 UTC "Zulu" avec une résolution de nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
vendorClientId	string ID client du fournisseur, le cas échéant.
metrics[]	enum (Metric) Métriques accessibles via ce lien de données. Si ce champ est vide, aucune restriction de métrique n'est appliquée. Pour le moment, ce champ n'est disponible qu'en version mono, et n'est compatible que si le type d'entité de l'association est GOOGLE_ADS_CAMPAIGN ou YT_RESERVE_LINE_ITEM.
gmpExportScopes[]	enum (GmpExportScope) Types de données exportées pour les associations Display &Video 360. N'est renseigné que lorsque la plate-forme est GOOGLE_MARKETING_PLATFORM. Si ce champ est vide, non spécifié, et toute combinaison de ces éléments peut être disponible.

Entité

Représente une entité publicitaire pouvant être associée à un client Ads Data Hub.

Représentation JSON
{ "entityId": string, "displayName": string, "type": enum (EntityType) }

Champs
entityId	string (int64 format) ID d'entité. La valeur indiquée ici dépend du type d'entité.
displayName	string Nom à afficher de l'entité.
type	enum (EntityType) Type d'entité associée.

EntityType

Entités publicitaires compatibles

Enums
ENTITY_TYPE_UNSPECIFIED	Type d'entité non spécifié.
GOOGLE_ADS_CUSTOMER	Client Google Ads. La entityId correspond à [Customer.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#customer] dans l'API Google Ads.
GOOGLE_ADS_CAMPAIGN	Une campagne Google Ads Le champ entityId correspond à [Campaign.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#campaign] dans l'API Google Ads.
GMP_CM_ACCOUNT	Un compte Campaign Manager Google Marketing Platform Le champ entityId correspond à [Accounts.id][https://developers.google.com/doubleclick-annonceurs/v3.3/accounts]
GMP_CM_FLOODLIGHT	Un compte Floodlight Campaign Manager Le champ entityId correspond à [FloodlightConfigurations.accountId][https://developers.google.com/doubleclick-annonceurs/v3.3/floodlightConfigurations]
GMP_DV360_PARTNER	Un ID de partenaire Display &Video 360. entityId est un ID de partenaire DV360.
GMP_DV360_ADVERTISER	Une référence annonceur Display &Video 360. Le entityId est une référence annonceur DV360.
GMP_DV360_ORDER	ID de commande Display &Video 360. entityId est un ID de commande DV360.
GMP_DV360_LINE_ITEM	ID d'élément de campagne Display &Video 360. entityId est un ID d'élément de campagne DV360.
YT_RESERVE_ORDER	ID de commande YouTube Reserve. entityId correspond à [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] dans le gestionnaire Google Ads.
YT_RESERVE_LINE_ITEM	Un élément de campagne YouTube Reserve entityId correspond à [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] dans le gestionnaire Google Ads.
VENDOR_CLIENT_ID_REGISTRATION	Un ID client de fournisseur enregistré manuellement par un fournisseur de technologie publicitaire tiers afin de fournir des mesures tierces.
GOOGLE_AD_MANAGER_ORDER	ID de campagne Google Ad Manager. entityId correspond à [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] dans le gestionnaire Google Ads.
GOOGLE_AD_MANAGER_LINE_ITEM	Un élément de campagne Google Ad Manager. entityId correspond à [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] dans le gestionnaire Google Ads.

Plate-forme

Plates-formes publicitaires compatibles

Enums
PLATFORM_UNSPECIFIED	Plate-forme non spécifiée.
GOOGLE_ADS	L'entité est associée à Google Ads.
GOOGLE_MARKETING_PLATFORM	L'entité est associée à Google Marketing Platform.
YOUTUBE_RESERVE	L'entité est associée à YouTube Reserve.
GOOGLE_AD_MANAGER	L'entité est associée à Google Ad Manager.
FREEWHEEL	L'entité est associée à FreeWheel.

Métrique

Métriques pouvant être diffusées via des liens de données d'annonces.

Enums
METRIC_UNSPECIFIED	Métrique non spécifiée.
BRAND_LIFT	Métrique correspondant au Brand Lift.
BRAND_SAFETY	Métrique correspondant à la brand safety.
REACH	Métrique correspondant à la couverture, où le client est l'annonceur.
VIEWABILITY	Métrique correspondant à la visibilité, où le client est l'annonceur.
PUBLISHER_REACH	Métrique correspondant à la couverture, où le client est l'éditeur/le fournisseur de contenu.
PUBLISHER_VIEWABILITY	Métrique correspondant à la visibilité, où le client est l'éditeur/le fournisseur de contenu.

GmpExportScope

Différents types de données pouvant être exportés pour les associations GMP.

Enums
GMP_EXPORT_SCOPE_UNSPECIFIED	Portée non spécifiée.
GMP_EXPORT_SCOPE_YT_TRUEVIEW	Les données TrueView YouTube DV360 doivent être exportées.
GMP_EXPORT_SCOPE_DT	Les données de transfert doivent être exportées.

Méthodes
batchApprove	Approuvez une liste de liens de données d'annonces en attente.
batchReject	Refuser une liste de liens de données relatives aux annonces en attente
list	Répertorie les associations entre le client spécifié et d'autres entités publicitaires Google.