Demander une association

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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.