Links auflisten

Sowohl Shopping-Partner als auch einzelne Händlerkonten können mehrere gekennzeichnete Verknüpfungen zwischen ihren Konten und anderen Konten haben. Die Methode listlinks gibt eine Liste aller dieser Verknüpfungen für das Merchant Center-Konto zurück, mit dem der API-Aufruf erfolgt. Es sind keine Parameter erforderlich und es wird mit einer HTTP-GET-Anfrage aufgerufen.

Dienststatus

Wenn Links aufgeführt werden, enthalten die Antworten ein status für jedes einzelne service innerhalb eines Links. Händler haben die Möglichkeit, alle aufgeführten Dienste oder nur eine Teilmenge der in der Anfrage vorgeschlagenen Dienste zu genehmigen.

Dienste haben anfangs den 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 auch andere pending- oder active-Dienste vorhanden sind. Sobald alle Dienste, aus denen ein Link besteht, entfernt wurden, 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 eine GET-Anfrage ohne Parameter mit der Methode listlinks.

GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks

Beispielantwort

In diesem Beispiel hat der Händler 98765 die Anfrage noch nicht genehmigt. Die einzelnen Dienste haben daher 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.