Um eine Beziehung mit einem Händlerkonto zu melden, muss ein Shopping-Partner zuerst mithilfe 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 action-Typ request hat. Jeder Link sollte auch eine Reihe von services enthalten, die angibt, welche Funktionen 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 (früher Shopping Actions) |
shoppingActionsOrderManagement |
Bestellverwaltung für Buy on Google (früher Shopping Actions) |
Außerdem muss eine Anfrage eine gültige linkType enthalten, mit der der Typ des Shopping-Partners beschrieben wird, von dem die Anfrage stammt. Shopping-Partnern wird eines der folgenden Labels zugewiesen und sie sollten beim API-Aufruf ihr jeweiliges Label im Feld linkType verwenden.
| 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 dem Wert "98765" für linkedAccountId gesendet.
Mit "eCommercePlatform" linkType wird der Partner als E-Commerce-Plattform identifiziert. Aus der Liste services geht hervor, dass der Partner die Funktionen "shoppingAdsProductManagement" (Produktdatenverwaltung für Shopping-Anzeigen) und "shoppingActionsOrderManagement" (Bestellverwaltung für Buy on Google, früher als Shopping Actions bezeichnet) 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.