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.

Lorsque vous associez un compte Google Ads à un autre compte produit, il existe deux manières différentes de procéder.

Processus d'invitation

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

  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 des comptes.
  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, que vous acceptez pour terminer 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 ProductLinkInvitationService.CreateProductLinkInvitation méthode 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 vérifier 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.
Annuler une invitation Utilisez la méthode ProductLinkInvitationService.RemoveProductLinkInvitation pour annuler 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 une invitation, car l'utilisateur dispose déjà d'un accès administrateur au compte invité. L'utilisateur doit utiliser ProductLinkService pour directement créer un lien actif.

Processus d'association directe

Le processus 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 un lien actif Utilisez ProductLinkService.CreateProductLink pour créer un ProductLink.
Désactiver un lien actif Utilisez ProductLinkService.RemoveProductLink pour supprimer un actif ProductLink.
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 association de compte a été tentée à l'aide du processus d'association directe, mais elle n'est pas prise en charge en raison d'un manque d'autorisations. L'utilisateur doit utiliser ProductLinkInvitationService pour suivre le processus d'invitation.
ProductLinkError.INVITATION_EXISTS Impossible de créer un lien, car une invitation en attente existe déjà.

Vous pouvez récupérer toutes les associations de produits associées à votre compte Google Ads à l'aide d'une requête GAQL sur la ressource product_link.

    SELECT
      product_link.product_link_id,
      product_link.type
    FROM product_link

Le champ product_link.type indique le type de produit ou de service associé. En fonction du type, d'autres champs de la ressource product_link seront renseignés, fournissant plus de détails sur l'association. Par exemple, si le type est THIRD_PARTY_APP_ANALYTICS, le champ third_party_app_analytics contient des informations sur le fournisseur d'analyse.

Cela vous permet d'obtenir une liste des services et applications externes directement associés à votre compte Google Ads, tels que Google Play, les partenaires de données ou les plates-formes d'analyse d'applications tierces.

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 listés précédemment. Pour les types d'association suivants, migrez depuis AccountLinkService et utilisez ProductLinkService :

  • GoogleAdsIdentifier
  • MerchantCenterIdentifier
  • AdvertisingPartnerIdentifier

Pour ThirdPartyAppAnalyticsLinkIdentifier, continuez à utiliser AccountLinkService.

Précédent
Gérer les invitations d'accès des utilisateurs
Suivant
Associer YouTube