リンクの一覧取得

ショッピング パートナーのアカウントと個々の販売アカウントのいずれも、アカウントと他のアカウントに複数のフラグ付きリンクを設定できます。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"
        }
    ]
}

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