Sowohl Shopping-Partner als auch individuelle Händlerkonten können mehrere markierte Verknüpfungen zwischen ihren und anderen Konten haben.
Die Methode listlinks
gibt eine Liste aller dieser Verknüpfungen für das Merchant Center-Konto zurück, über das der API-Aufruf erfolgt. Sie benötigt keine Parameter und wird mit einer HTTP-GET
-Anfrage aufgerufen.
Dienststatus
Beim Auflisten von Links wird in den Antworten für jede einzelne service
innerhalb eines Links ein status
angezeigt. Händler können entweder alle aufgeführten Dienste oder nur einen Teil der in der Anfrage vorgeschlagenen Dienstleistungen genehmigen.
Dienste haben den Status pending
, bis sie von einem Händler ausdrücklich genehmigt wurden. Nach der Genehmigung haben Dienste den Status active
.
Entfernte Dienste haben den Status inactive
, wenn weitere pending
- oder active
-Dienste vorhanden sind. Nachdem alle Dienste entfernt wurden, zu denen ein Link gehört, wird der Link nicht mehr von der Methode listlinks
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. Daher haben die einzelnen Dienstleistungen den Status pending
.
{
"linkedAccountId": "98765",
"services": [
{
"service": "shoppingAdsProductManagement",
"status": "pending"
},
{
"service": "shoppingActionsOrderManagement",
"status": "pending"
}
]
}
Im nächsten Abschnitt wird beschrieben, wie Sie eine Verknüpfungsanfrage genehmigen.