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 un linkedAccountId qui identifie le marchand recevant la demande, et une action définie 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 Acheter sur Google (anciennement Shopping Actions) |
shoppingActionsOrderManagement |
Gestion des commandes pour Acheter sur Google (anciennement Shopping Actions) |
En outre, une demande doit également contenir un linkType valide qui décrit le type de partenaire Shopping à l'origine de la demande. Les partenaires Shopping se voient attribuer l'un des libellés suivants, qu'ils doivent utiliser dans le champ linkType lors de l'appel d'API.
| Types de liens 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 linkType "eCommercePlatform" identifie le partenaire comme une plate-forme d'e-commerce. La liste 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 Acheter sur Google, anciennement Shopping Actions).
POST https://shoppingcontent.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.