Sowohl Shopping-Partner als auch einzelne Händlerkonten können mehrfach markierte Verknüpfungen zwischen ihren Konten und anderen Konten haben.
Über die Methode listlinks
wird eine Liste aller Links für das Merchant Center-Konto zurückgegeben, über das der API-Aufruf erfolgt. Sie erfordert keine Parameter und wird mit einer HTTP-GET
-Anfrage aufgerufen.
Dienststatus
Bei der Auflistung von Links wird in den Antworten ein status
für jede einzelne service
innerhalb eines Links angezeigt. Händler haben die Möglichkeit, entweder alle aufgeführten Dienstleistungen oder nur einen Teil der in der Anfrage vorgeschlagenen Dienstleistungen zu genehmigen.
Dienstleistungen beginnen mit dem Status pending
, bis sie explizit von einem Händler genehmigt werden. Nach der Genehmigung haben Dienste den Status active
.
Entfernte Dienste haben den Status inactive
, wenn noch andere pending
- oder active
-Dienste vorhanden sind. Sobald alle Dienste mit einem Link entfernt wurden, wird der Link von der Methode listlinks
nicht mehr zurückgegeben.
Beispielanfrage
Wenn Sie die vom Partner 123456789
gesendete Verknüpfungsanfrage auflisten möchten, senden Sie mit der Methode listlinks
eine GET
-Anfrage ohne Parameter.
GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks
Beispielantwort
In diesem Beispiel muss der Händler 98765
die Anfrage noch genehmigen, sodass die einzelnen Dienstleistungen den Status pending
haben.
{
"linkedAccountId": "98765",
"services": [
{
"service": "shoppingAdsProductManagement",
"status": "pending"
},
{
"service": "shoppingActionsOrderManagement",
"status": "pending"
}
]
}
Im nächsten Abschnitt wird beschrieben, wie Sie eine Verknüpfungsanfrage genehmigen.