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.