リンクの一覧取得

ショッピング パートナーと個々の販売アカウントのどちらでも、アカウントと別のアカウント間で複数のフラグ付きリンクを設定できます。listlinks メソッドは、API 呼び出しを行っている Merchant Center アカウントのすべてのリンクのリストを返します。パラメータは不要で、HTTP GET リクエストを使用して呼び出されます。

サービスのステータス

リンクをリストすると、レスポンスではリンク内の個々の service ごとに status が表示されます。販売者は、リストされたすべてのサービスを承認することも、リクエストで提案されたサービスのサブセットのみを承認することもできます。

サービスは、販売者によって明示的に承認されるまで、pending ステータスで開始します。承認されると、サービスは active ステータスになります。

他の pending または active サービスも存在する場合、削除されたサービスには inactive のステータスが表示されます。リンクを構成するすべてのサービスが削除されると、listlinks メソッドからリンクは返されなくなります。

リクエストの例

パートナー 123456789 から送信されたリンク リクエストを一覧表示するには、listlinks メソッドを使用して、パラメータを指定せずに GET リクエストを送信します。

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

レスポンスの例

この例では、販売者 98765 はまだリクエストを承認していないため、個々のサービスは pending ステータスになります。

{
    "linkedAccountId": "98765",
    "services": [
        {
            "service": "shoppingAdsProductManagement",
            "status": "pending"
        },
        {
            "service": "shoppingActionsOrderManagement",
            "status": "pending"
        }
    ]
}

次のセクションでは、リンク リクエストを承認する方法について説明します。