Mappages de champs

Utilisez les mappages de champs pour migrer chaque étape de vos workflows de liens de partenaire de l'API Google Ads vers l'API Gestionnaire de données :

Mappages des champs d'objet

Utilisez les mappages dans les tableaux pour mapper un ProductLink dans l'API Google Ads à son équivalent PartnerLink dans l'API Gestionnaire de données.

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, et 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 le compte auquel appartient un lien existant. 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 appartient un lien existant. 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 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 des demandes de gestion des associations

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

Créer une demande

Voici les correspondances de champs pour 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éfini sur le nom de ressource du compte d'annonceur propriétaire.
product_link partner_link Définissez sur la ressource PartnerLink. Consulter les mappages de champs d'objet

Supprimer la demande

Voici les correspondances de champs pour 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 englobe les comptes propriétaires et partenaires. Ce champ supplémentaire n'est donc pas nécessaire.
resource_name name Définissez sur le nom de ressource de l'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 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 dans 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 correspondances de champs pour 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 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.

Consultez Récupérer les liens partenaires pour en savoir plus, y compris sur la façon de construire le filter d'une requête SearchPartnerLinksRequest et de définir les en-têtes de requête pour différents scénarios.

Précédent
Procédure de mise à jour