Links auflisten

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.