L'API Google Ads permet d'associer des comptes Google Ads à d'autres comptes produit. Ce guide explique comment utiliser la version 16 de l'API pour associer vos comptes.
Comment associer des comptes
Lorsque vous associez un compte Google Ads à un autre compte produit, vous avez le choix entre deux méthodes.
Processus d'invitation
Le parcours d'invitation est utilisé lorsque vous disposez d'un accès administrateur au compte Google Ads, mais pas au compte produit. Cette procédure 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 terminer le processus d'association.
- 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 terminez le processus d'association.
Dans ce scénario, les méthodes suivantes sont utilisées:
| 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 d'API Google Ads le définira sur REQUESTED une fois l'appel d'API terminé. |
| 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 mettre à jour l'état de
ProductLinkInvitation sur ACCEPTED ou REJECTED. |
|
| Annuler une invitation | Utilisez la méthode
ProductLinkInvitationService.RemoveProductLinkInvitation pour révoquer une
ProductLinkInvitation existante. |
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 l'invitation, car l'utilisateur dispose déjà d'un accès administrateur au compte invité. L'utilisateur doit utiliser ProductLinkService pour créer directement une association active. |
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 devez associer directement le compte Google Ads au compte produit au lieu d'envoyer une invitation.
Dans ce scénario, les méthodes suivantes sont utilisées:
| Action | Remarques |
|---|---|
| Créer une association active | Utilisez
ProductLinkService.createProductLink pour créer un ProductLink. |
| Désactiver une association active | 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 être générées dans ce workflow:
| Code d'erreur | Explication |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
Une tentative d'association de compte a été effectuée à l'aide du flux d'association directe, mais elle n'est pas acceptée, car vous ne disposez pas des autorisations nécessaires. L'utilisateur doit utiliser ProductLinkInvitationService à la place pour le flux d'invitation.
|
ProductLinkError.INVITATION_EXISTS |
Impossible de créer une association, car une invitation en attente existe déjà. |
Modifications apportées aux services AccountLinkService et MerchantCenterLinkService
Si vous avez déjà utilisé MerchantCenterLinkService ou AccountLinkService pour associer un compte Google Ads à un autre compte produit, vous devez migrer votre application existante vers l'un des workflows énumérés précédemment. Le tableau suivant indique l'état de la migration:
| Type de lien | Disponible dans les nouveaux services ? | Assistance disponible à partir du | Remarques |
|---|---|---|---|
DataPartnerIdentifier |
Oui | v15 | Migrer en dehors de MerchantCenterLinkService |
GoogleAdsIdentifier |
Oui | v16 | Migrer le service AccountLinkService |
MerchantCenterIdentifier |
Oui | v16 | Migrer le service AccountLinkService |
AdvertisingPartnerIdentifier |
Oui | v16 | Migrer le service AccountLinkService |
ThirdPartyAppAnalyticsLinkIdentifier |
Non | – | Continuer à utiliser AccountLinkService |