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.