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 einen linkedAccountId, der den Händler identifiziert, der die Anfrage erhält, und den action-Typ request haben. Jeder Link sollte auch eine Reihe von services angeben, in der aufgezählt wird, welche Funktionen der Partner dem Händler bereitstellt. 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 einen gültigen linkType enthalten, der den Typ des Shopping-Partners beschreibt, der die Anfrage stellt. Shopping-Partnern wird eines der folgenden Labels zugewiesen und sie müssen beim Aufruf der API das entsprechende Label im Feld linkType verwenden.
| Gültige linkTypes |
|---|
channelPartner |
eCommercePlatform |
Beispiel
Mit dem folgenden API-Aufruf wird eine Verknüpfungsanfrage vom Partnerkonto 123456789 an einen Händler mit linkedAccountId von "98765" gesendet.
Mit dem "eCommercePlatform"-linkType wird der Partner als E-Commerce-Plattform identifiziert. In der Liste services ist angegeben, 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.