Wenn ein Shopping-Partner eine Beziehung zu einem Händlerkonto kennzeichnen möchte, muss er zuerst mit der Methode accounts.link eine Verknüpfungsanfrage senden.
Die Verknüpfungsanfrage enthält eine linkedAccountId, die den Händler identifiziert, der die Anfrage erhält, und den Typ action = request hat. Jeder Link sollte auch eine Reihe von services enthalten, in denen die Funktionen aufgeführt sind, die der Partner dem Händler zur Verfügung stellt. Die folgenden services-Werte werden unterstützt.
| Dienst | Beschreibung |
|---|---|
shoppingAdsProductManagement |
Produktdatenverwaltung für Shopping-Anzeigen |
shoppingActionsProductManagement |
Produktdatenverwaltung für Buy on Google (ehemals Shopping Actions) |
shoppingActionsOrderManagement |
Bestellverwaltung für Buy on Google (ehemals Shopping Actions) |
Außerdem muss eine Anfrage auch ein gültiges linkType enthalten, das den Typ des anfragenden Shopping-Partners beschreibt. Shopping-Partnern wird eines der folgenden Labels zugewiesen. Sie sollten das entsprechende Label im Feld linkType verwenden, wenn sie die API aufrufen.
| Gültige linkTypes |
|---|
channelPartner |
eCommercePlatform |
Beispiel
Mit dem folgenden API-Aufruf wird eine Verknüpfungsanfrage vom Konto eines Partners (123456789) an einen Händler mit der linkedAccountId "98765" gesendet.
Die "eCommercePlatform" linkType identifiziert den Partner als E-Commerce-Plattform. Die Liste services gibt an, dass der Partner die Funktionen "shoppingAdsProductManagement" (Produktdatenverwaltung für Shopping-Anzeigen) und "shoppingActionsOrderManagement" (Bestellverwaltung für Buy on Google, früher Shopping Actions) anbietet.
POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
"linkedAccountId": "98765",
"linkType": "eCommercePlatform",
"services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
"action": "request"
}
Im nächsten Abschnitt wird beschrieben, wie Sie eine Liste der vorhandenen Links abrufen.