Pour signaler une relation avec un compte marchand, un partenaire Shopping doit d'abord utiliser la méthode Accounts.link pour envoyer une demande d'association.
La demande d'association contient le paramètre linkedAccountId qui identifie le marchand recevant la demande, et le paramètre action défini sur request. Chaque association doit également spécifier un ensemble de services qui énumère les fonctionnalités que le partenaire fournit au marchand. Les valeurs de services suivantes sont acceptées.
| Service | Description |
|---|---|
shoppingAdsProductManagement |
Gestion des données produit pour les annonces Shopping |
shoppingActionsProductManagement |
Gestion des données produit pour Shopping Actions |
shoppingActionsOrderManagement |
Gestion des commandes pour Shopping Actions |
En outre, une requête doit également contenir un paramètre linkType valide qui décrit le type de partenaire Shopping à l'origine de la requête. Les partenaires Shopping se voient attribuer un des libellés suivants, qu'ils doivent utiliser dans le champ linkType lors de l'appel d'API.
| Types d'associations (linkTypes) valides |
|---|
channelPartner |
eCommercePlatform |
Exemple
L'appel d'API suivant envoie une demande d'association depuis le compte 123456789 d'un partenaire à un marchand avec le paramètre linkedAccountId défini sur "98765".
Le paramètre linkType "eCommercePlatform" identifie le partenaire comme une plate-forme d'e-commerce. La liste de services indique que le partenaire fournit les fonctionnalités "shoppingAdsProductManagement" (gestion des données produit pour les annonces Shopping) et "shoppingActionsOrderManagement" (gestion des commandes pour Shopping Actions).
POST https://www.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
"linkedAccountId": "98765",
"linkType": "eCommercePlatform",
"services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
"action": "request"
}
La section suivante explique comment obtenir la liste des associations existantes.