Mappages de champs

Utilisez les mappages de champs pour migrer chaque étape de vos workflows de liens partenaires de l'API Google Ads vers l'API Data Manager :

Authentification

L'API Data Manager nécessite des identifiants avec un champ d'application différent de celui de l'API Google Ads. Vous devez générer de nouveaux identifiants incluant le champ d'application de l'API Data Manager pour gérer les liens des partenaires.

Mappages de champs d'objets

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

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 champ partner_account sur ProductAccount, puis définissez ses champs 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 champ customer_id de l'objet resource_name d'un ProductLink indique quel compte est propriétaire d'une association existante. Lorsque vous créez un ProductLink, vous indiquez le propriétaire du lien en définissant le customer_id d'un CreateProductLinkRequest.

Dans l'API Data Manager, la combinaison de accountType et de accountId de owning_account indique quel compte est propriétaire d'une association existante. Lorsque vous créez un PartnerLink, vous indiquez le propriétaire du lien en définissant name sur le nom de ressource du propriétaire.

Pour en savoir plus, consultez Noms de ressources et Créer une requête.

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, le nom d'une ressource PartnerLink utilise le format suivant :

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

Mappages des requêtes de gestion des associations

Utilisez les mappages de requêtes de cette section pour convertir les requêtes de création, de suppression et de récupération des liens de partenaires.

Créer une demande

Voici les mappages de champs permettant de convertir un CreateProductLinkRequest de 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 d'annonceur propriétaire.
product_link partner_link Définissez cette option sur la ressource PartnerLink. Consultez Mappages de champs d'objets.

Supprimer la demande

Voici les mappages de champs permettant de convertir un RemoveProductLinkRequest de 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 des demandes de récupération de liens

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

API Google Ads

Envoyez une SearchGoogleAdsRequest contenant un query. La clause facultative WHERE 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 une SearchPartnerLinksRequest. Le champ de requête facultatif filter 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 de 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 cette option sur le nom de ressource du compte à rechercher.
page_size page_size
page_token page_token
query filter Définissez filter pour définir les ressources à renvoyer. L'API Data Manager renvoie des ressources complètes. Il n'y a donc pas d'équivalent à la clause SELECT.
search_settings Aucun équivalent.
validate_only Aucun équivalent.

Pour en savoir plus, consultez Récupérer les liens partenaires. Vous y découvrirez notamment comment construire le filter d'une requête SearchPartnerLinksRequest et définir des en-têtes de requête pour différents scénarios.