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 :
- Mappages de champs d'objets contient les mappages de champs pour la ressource qui représente un objet de lien partenaire.
- Mappages de requêtes de gestion des liens contient les mappages de champs pour les requêtes de création et de suppression d'un lien partenaire.
- Mappages de requêtes de récupération de liens contient des mappages de champs pour récupérer les liens des partenaires.
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 |
|---|---|---|
|
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
Dans l'API Data Manager, la combinaison de 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
ProductLinkutilise le format suivant :customers/{customer_id}/productLinks/{product_link_id}- API Data Manager
Dans l'API Data Manager, le nom d'une ressource
PartnerLinkutilise 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
SearchGoogleAdsRequestcontenant unquery. La clause facultativeWHEREde la requête définit les ressources à renvoyer. La clauseSELECTde 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 facultatiffilterdé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.