Links auflisten

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.