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 pour associer des comptes
Lorsque vous associez un compte Google Ads à un autre compte produit, l'association peut s'effectuer de deux manières différentes.
Processus d'invitation
Utilisez le flux d'invitation lorsque vous disposez d'un accès administrateur au compte Google Ads, mais pas au compte du produit. Ce flux fonctionne dans deux scénarios :
- Vous souhaitez associer les deux comptes et créer une invitation pour un administrateur du compte du produit. L'administrateur du compte produit accepte l'invitation pour finaliser l'association des comptes.
- L'administrateur du compte du 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 finaliser le processus d'association.
Utilisez les méthodes suivantes 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 champ 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é. Lorsque vous créez une invitation pour un partenaire publicitaire (AdvertisingPartnerLinkInvitationIdentifier), advertising_partner_properties.allowed_domain est obligatoire à partir de la version 25 (et facultatif dans la version 24 et les versions antérieures). |
| 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 remplacer l'état de
ProductLinkInvitation par 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. |
ProductLinkInvitationError.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
Utilisez le flux d'association directe lorsque vous disposez d'un accès administrateur au compte Google Ads et au compte du produit. Dans ce cas, associez directement le compte Google Ads au compte produit au lieu d'envoyer une invitation.
Utilisez les méthodes suivantes 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 ê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 de lien direct, mais elle n'est pas possible en raison d'un manque d'autorisations. L'utilisateur doit utiliser ProductLinkInvitationService pour effectuer le flux d'invitation.
|
ProductLinkError.INVITATION_EXISTS |
Impossible de créer une association, car une invitation est déjà en attente. |
Récupérer les associations de produits existantes
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é.
Selon le type, d'autres champs de la ressource product_link seront renseignés, fournissant plus de détails sur le lien. Par exemple, si le type est DATA_PARTNER, le champ data_partner contiendra des informations sur le compte du partenaire pour les données associé.
Cela vous permet d'obtenir la liste des services externes et des comptes de produits associés directement à votre compte Google Ads, comme Merchant Center, Google Ads, les partenaires publicitaires ou les partenaires pour les données.
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 de liens suivants, migrez depuis AccountLinkService et utilisez ProductLinkService :
Pour ThirdPartyAppAnalyticsLinkIdentifier, continuez à utiliser AccountLinkService.