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
Il existe deux façons d'associer un compte Google Ads à un autre compte de produit.
Processus d'invitation
Utilisez le processus d'invitation lorsque vous disposez d'un accès administrateur au compte Google Ads, mais pas au compte de produit. Ce processus fonctionne dans deux cas de figure :
- Vous souhaitez associer les deux comptes et créer une invitation pour un administrateur du compte de produit. L'administrateur du compte de produit accepte l'invitation pour terminer le processus d'association des comptes.
- L'administrateur du compte de produit souhaite associer les deux comptes, mais n'a pas accès au compte Google Ads. L'administrateur du compte de produit crée une invitation, que vous acceptez pour terminer le processus d'association.
Dans ce scénario, utilisez les méthodes suivantes :
| 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 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). |
| 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. |
|
| Révoquer 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. |
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 directement créer un lien actif. |
Processus d'association directe
Utilisez le processus d'association directe lorsque vous disposez d'un accès administrateur au compte Google Ads et au compte de produit. Dans ce cas, associez directement le compte Google Ads au compte de produit au lieu d'envoyer une invitation.
Dans ce scénario, utilisez les méthodes suivantes :
| 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 tentative d'association de compte a été effectué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 effectuer le processus d'invitation.
|
ProductLinkError.INVITATION_EXISTS |
Impossible de créer un lien, car une invitation en attente existe déjà. |
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é.
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 DATA_PARTNER, le champ data_partner contient des informations sur le compte de partenaire de données associé.
Vous pouvez ainsi obtenir une liste des services externes et des comptes de produits associés directement à votre compte Google Ads, tels que Merchant Center, Google Ads, les partenaires publicitaires ou les partenaires de données.
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 d'association suivants, migrez depuis
AccountLinkService et utilisez ProductLinkService :
Pour ThirdPartyAppAnalyticsLinkIdentifier, continuez à utiliser
AccountLinkService.