rocket
Content API for Shopping の正式な後継である
Merchant API をご紹介します。
update
Merchant API の新機能、バグの修正、更新に関する
最新情報を入手してください。
add_alert
注: Content API for Shopping は 2026 年 8 月 18 日に廃止されます。
リンクの一覧取得
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
ショッピング パートナーと個々の販売者アカウントの両方で、アカウント間や他のアカウントとの間で複数のフラグ付きリンクを設定できます。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"
}
]
}
次のセクションでは、リンク リクエストを承認する方法について説明します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-13 UTC。
[null,null,["最終更新日 2025-08-13 UTC。"],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of the platform.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003elistlinks\u003c/code\u003e method allows retrieval of all flagged links between accounts, providing insight into account relationships.\u003c/p\u003e\n"],["\u003cp\u003eEach service within a link has a status, starting as \u003ccode\u003epending\u003c/code\u003e, transitioning to \u003ccode\u003eactive\u003c/code\u003e upon approval, and ultimately becoming \u003ccode\u003einactive\u003c/code\u003e when removed.\u003c/p\u003e\n"],["\u003cp\u003eA simple HTTP GET request to the \u003ccode\u003elistlinks\u003c/code\u003e endpoint is sufficient to retrieve link information without requiring any parameters.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. The `listlinks` method retrieves all links between merchant accounts without parameters via a `GET` request. Each service within a link has a `status`: `pending` (awaiting merchant approval), `active` (approved), or `inactive` (removed, but other services remain). Once all services are removed, the link is no longer listed. A `GET` request example and the `listlinks` method's response format are provided.\n"],null,["# List links\n\nBoth Shopping partners and individual merchant accounts can have multiple\nflagged links between their accounts and others.\nThe [`listlinks`](/shopping-content/reference/rest/v2.1/accounts/listlinks) method\nreturns a list of all these links for the merchant center account\nmaking the API call. It does not require any parameters and is invoked using an\nHTTP `GET` request.\n\nService status\n--------------\n\nWhen listing links, responses will show a `status` for each individual `service`\nwithin a link. Merchants have the option to either approve all listed services\nor only a subset of those proposed in the request.\n\nServices start out in a `pending` status until explicitly [approved by a\nmerchant](/shopping-content/guides/flagging/approve). After they are approved, services have an `active` status.\n\nRemoved services will show a status of `inactive` if there are other `pending`\nor `active` services also present. Once all services comprising a link are\nremoved, the link will no longer be returned by the\n[`listlinks`](/shopping-content/reference/rest/v2.1/accounts/listlinks) method.\n\nExample request\n---------------\n\nTo list the link request sent by partner `123456789`, send a `GET`\nrequest with no parameters using the [`listlinks`](/shopping-content/reference/rest/v2.1/accounts/listlinks) method. \n\n GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks\n\nExample response\n----------------\n\nIn this example, the merchant `98765` has yet to approve the request, so the\nindividual services have a `pending` status. \n\n {\n \"linkedAccountId\": \"98765\",\n \"services\": [\n {\n \"service\": \"shoppingAdsProductManagement\",\n \"status\": \"pending\"\n },\n {\n \"service\": \"shoppingActionsOrderManagement\",\n \"status\": \"pending\"\n }\n ]\n }\n\nThe [next section](/shopping-content/guides/flagging/approve) describes how to approve a linking request."]]