Associer des comptes produit

L'API Google Ads permet d'associer des comptes Google Ads à d'autres comptes produit. Ce guide explique comment utiliser l'API pour associer vos comptes.

Associer des comptes

Lorsque vous associez un compte Google Ads à un autre compte produit, deux possibilités s'offrent à vous.

Processus d'invitation

Le flux d'invitation est utilisé lorsque vous disposez d'un accès administrateur au compte Google Ads, mais pas au compte produit. Ce flux fonctionne dans deux scénarios :

1. 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 terminer le processus d'association du compte.
2. 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, et vous l'acceptez pour finaliser l'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 à la fin de l'appel d'API.
	Inspecter 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 sur status = PENDING_APPROVAL pour accepter ou refuser une invitation en attente.
	Accepter ou refuser une invitation	Utilisez la méthode ProductLinkInvitationService.UpdateProductLinkInvitation pour définir l'état de ProductLinkInvitation sur ACCEPTED ou REJECTED.
	Révoquer une invitation	Utilisez la méthode ProductLinkInvitationService.RemoveProductLinkInvitation pour révoquer un ProductLinkInvitation existant.

Les erreurs courantes suivantes peuvent être générées 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, vous 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 une association active	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 associations actives	Utilisez GoogleAdsService.Search ou GoogleAdsService.SearchStream pour interroger la ressource product_link.

Les erreurs courantes suivantes peuvent être générées dans ce workflow :

Code d'erreur	Explication
ProductLinkError.CREATION_NOT_PERMITTED	Une tentative d'association de comptes a été effectuée à l'aide du flux d'association directe, mais cette opération n'est pas prise en charge en raison d'un manque d'autorisations. À la place, l'utilisateur doit utiliser ProductLinkInvitationService pour effectuer le flux d'invitation.
ProductLinkError.INVITATION_EXISTS	Impossible de créer une association, 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 produit, vous devez migrer votre application existante vers l'un des workflows répertoriés précédemment. Pour les types de liens suivants, migrez depuis AccountLinkService et utilisez ProductLinkService :

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

Pour ThirdPartyAppAnalyticsLinkIdentifier, continuez à utiliser AccountLinkService.