L'API Google Ads permet d'associer des comptes Google Ads à d'autres comptes de produits. Ce guide explique comment utiliser l'API pour associer vos comptes.
Méthodes d'association de comptes
Lorsque vous associez un compte Google Ads à un autre compte de produit, il existe deux façons de procéder.
Processus d'invitation
La procédure d'invitation est utilisée lorsque vous disposez d'un accès administrateur au compte Google Ads, mais pas au compte produit. Ce flux fonctionne dans deux scénarios :
- Vous souhaitez associer les deux comptes et créer une invitation pour un administrateur du compte produit. L'administrateur du compte produit accepte l'invitation pour finaliser l'association des comptes.
- L'administrateur du compte produit souhaite associer les deux comptes, mais n'a pas accès au compte Google Ads. L'administrateur du compte produit crée une invitation, que vous acceptez et pour laquelle vous finalisez le processus d'association.
Les méthodes suivantes sont utilisées dans ce scénario :
| Scénario | Action | Remarques |
|---|---|---|
| Scénario 1 | Créer une invitation | Utilisez la méthode
ProductLinkInvitationService.CreateProductLinkInvitation pour créer une invitation. Le status de
ProductLinkInvitation ne doit pas être défini. Le serveur de l'API Google Ads le définira sur REQUESTED une fois l'appel d'API terminé. |
| Vérifier l'état d'une invitation | Utilisez GoogleAdsService.Search ou GoogleAdsService.SearchStream pour interroger la ressource product_link_invitation et inspecter son état. |
|
| Scénario 2 | Récupérer une invitation | Utilisez GoogleAdsService.Search ou GoogleAdsService.SearchStream pour interroger la ressource product_link_invitation. Filtrez la liste sur
status = PENDING_APPROVAL pour accepter ou refuser
une invitation en attente. |
| Accepter ou refuser une invitation | Utilisez la méthode
ProductLinkInvitationService.UpdateProductLinkInvitation pour mettre à jour l'état de
ProductLinkInvitation sur ACCEPTED ou REJECTED. |
|
| Annuler une invitation | Utilisez la méthode
ProductLinkInvitationService.RemoveProductLinkInvitation pour révoquer un
ProductLinkInvitation existant. |
Les erreurs courantes suivantes peuvent se produire dans ce workflow :
| Code d'erreur | Explication |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
Le client n'est pas autorisé à effectuer cette action. |
ProductLinkError.NO_INVITATION_REQUIRED |
Impossible de créer une invitation, car l'utilisateur dispose déjà d'un accès administrateur au compte invité. L'utilisateur doit utiliser ProductLinkService pour créer directement un lien actif. |
Flux d'association directe
Le flux d'association directe est utilisé lorsque vous disposez d'un accès administrateur au compte Google Ads et au compte produit. Dans ce cas, associez directement le compte Google Ads au compte produit au lieu d'envoyer une invitation.
Les méthodes suivantes sont utilisées dans ce scénario :
| Action | Remarques |
|---|---|
| Créer un lien actif | Utilisez
ProductLinkService.createProductLink pour créer un ProductLink. |
| Désactiver un lien actif | Utilisez
ProductLinkService.removeProductLink pour supprimer un ProductLink actif. |
| Récupérer les liens actifs | Utilisez
GoogleAdsService.Search ou GoogleAdsService.SearchStream pour interroger la ressource
product_link. |
Les erreurs courantes suivantes peuvent se produire dans ce workflow :
| Code d'erreur | Explication |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Une association de compte a été tentée à l'aide du flux de lien direct, mais elle n'est pas prise en charge en raison du manque d'autorisations. L'utilisateur doit utiliser ProductLinkInvitationService pour effectuer le processus d'invitation.
|
ProductLinkError.INVITATION_EXISTS |
Impossible de créer un lien, car une invitation en attente existe déjà. |
Modifications apportées à AccountLinkService
Si vous utilisez AccountLinkService pour associer un compte Google Ads à un autre compte de produit, vous devez migrer votre application existante vers l'un des workflows listés précédemment. Pour les types de liens suivants, migrez depuis AccountLinkService et utilisez ProductLinkService :
GoogleAdsIdentifierMerchantCenterIdentifierAdvertisingPartnerIdentifier
Pour ThirdPartyAppAnalyticsLinkIdentifier, continuez à utiliser AccountLinkService.