Mappages de champs

Utilisez les mappages de champs pour mettre à niveau chaque étape de vos workflows d'association de partenaires de l'API Google Ads vers l'API Data Manager :

• Les mappages de champs d'objet contiennent des mappages de champs pour la ressource qui représente un objet d'association de partenaires.
• Les mappages de requêtes de gestion des associations contiennent des mappages de champs pour les requêtes permettant de créer et de supprimer une association de partenaires.
• Les mappages de requêtes de récupération des associations contiennent des mappages de champs pour récupérer des associations de partenaires.

Mappages de champs d'objet

Utilisez les mappages des tableaux pour mapper un ProductLink dans l' API Google Ads à son PartnerLink équivalent dans l'API Data Manager.

Important : Un ProductLink et un PartnerLink sont des représentations différentes de la même entité d'association sous-jacente. Si vous disposez déjà d'un ProductLink dans l'API Google Ads , vous pouvez le récupérer et le gérer en tant que PartnerLink dans l'API Data Manager. N'essayez pas de créer un autre PartnerLink pour la même paire de comptes.

ProductLink (API Google Ads)	PartnerLink (API Data Manager)	Remarques
advertising_partner data_partner google_ads merchant_center	partner_account	L'API Data Manager ne comporte pas de champs distincts pour chaque type de compte associé. Pour tous les types de comptes, définissez le partner_account champ sur un ProductAccount, puis définissez ses account_type et account_id pour identifier le compte associé.
product_link_id	partner_link_id
resource_name	name	Dans l'API Google Ads, le customer_id du resource_name d'un ProductLink indique à quel compte appartient une association existante. Lorsque vous créez un ProductLink, vous indiquez le propriétaire de l'association en définissant le customer_id d'un CreateProductLinkRequest. Dans l'API Data Manager, la combinaison de accountType et accountId du owning_account indique à quel compte appartient une association existante. Lorsque vous créez un PartnerLink, vous indiquez le propriétaire de l'association en définissant le name sur le nom de ressource du propriétaire. Pour en savoir plus, consultez Noms de ressources et Créer une demande.
type	owning_account.account_type

Noms de ressources

L'API Data Manager utilise un format de nom de ressource différent de celui de l'API Google Ads.

API Google Ads

Dans l'API Google Ads, un nom de ressource ProductLink utilise le format suivant :

customers/{customer_id}/productLinks/{product_link_id}

API Data Manager

Dans l'API Data Manager, un nom de ressource PartnerLink utilise le format suivant :

accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

Mappages de requêtes de gestion des associations

Utilisez les mappages de requêtes de cette section pour convertir les requêtes permettant de créer, de supprimer et de récupérer des associations de partenaires.

Créer une demande

Voici les mappages de champs permettant de convertir un CreateProductLinkRequest dans l'API Google Ads en son équivalent CreatePartnerLinkRequest dans l'API Data Manager.

CreateProductLinkRequest (API Google Ads)	CreatePartnerLinkRequest (API Data Manager)	Remarques
customer_id	parent	Définissez le nom de ressource du compte annonceur propriétaire.
product_link	partner_link	Définissez la ressource PartnerLink. Consultez Mappages de champs d'objet.

Supprimer la demande

Voici les mappages de champs permettant de convertir un RemoveProductLinkRequest dans l'API Google Ads en son équivalent DeletePartnerLinkRequest dans l'API Data Manager.

RemoveProductLinkRequest (API Google Ads)	DeletePartnerLinkRequest (API Data Manager)	Remarques
customer_id	Aucun équivalent.	Le champ name encapsule les comptes propriétaire et partenaire Ce champ supplémentaire n'est donc pas nécessaire.
resource_name	name	Définissez le nom de ressource du PartnerLink que vous souhaitez supprimer.
validate_only	Aucun équivalent.

Mappages de requêtes de récupération des associations

L'approche pour récupérer les associations de partenaires diffère entre l'API Google Ads et l'API Data Manager.

API Google Ads

Envoyez un SearchGoogleAdsRequest contenant un query. La clause WHERE facultative de la requête définit les ressources à renvoyer. La clause SELECT de la requête définit les champs à renseigner sur les ressources partielles renvoyées.

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...

API Data Manager

Envoyez un SearchPartnerLinkRequest. Le champ de requête filter facultatif définit les ressources à renvoyer. La réponse contient des ressources complètes, avec tous les champs renseignés.

Voici les mappages de champs permettant de convertir un SearchGoogleAdsRequest dans l'API Google Ads en son équivalent SearchPartnerLinksRequest dans l'API Data Manager.

SearchGoogleAdsRequest (API Google Ads)	SearchPartnerLinksRequest (API Data Manager)	Remarques
customer_id	parent	Définissez le nom de ressource du compte à rechercher.
page_size	page_size
page_token	page_token
query	filter	Définissez le filter pour définir les ressources à renvoyer. L'API Data Manager renvoie des ressources complètes. Il n'existe donc pas d'équivalent à la clause SELECT.
search_settings	Aucun équivalent.
validate_only	Aucun équivalent.

Pour en savoir plus, y compris sur la façon de créer le filter d'une SearchPartnerLinksRequest requête et de définir des en-têtes de requête pour différents scénarios, consultez Récupérer des associations de partenaires.