rocket
Content API for Shopping の正式な後継である
Merchant API をご紹介します。
update
Merchant API の新機能、バグの修正、更新に関する
最新情報を入手してください。
add_alert
注: Content API for Shopping は 2026 年 8 月 18 日に廃止されます。
ビジネス プロフィールのリンク
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Merchant Center にローカル在庫を提供するには、まず Merchant Center がどのビジネスを担当するかを指定する必要があります。Content API を介してビジネス プロフィールからビジネス グループの候補リストを取得できますが、まずビジネス プロフィールへのアクセスをリクエストする必要があります。
ビジネス プロフィールへのアクセス権をリクエストする
ビジネス プロフィールへのアクセス権限をリクエストするには、liasettings.requestgmbaccess
メソッドを使用します。
POST https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890/requestgmbaccess?gmbEmail=admin@example.com
この例に示すように、gmbEmail
クエリ パラメータはビジネス プロフィールの管理者のメールアドレスを指定します。
このメソッドを呼び出すと、指定された管理者にアクセス リクエストを承認するか拒否するかを尋ねるメールが届きます。管理者が対応しなかった場合、このリクエストは 7 日後に期限切れになります。
使用可能なビジネス グループを一覧表示する
アクセスが許可されると、liasettings.getaccessiblegmbaccounts
メソッドを呼び出すことで、利用可能なビジネスを確認できます。
GET https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890/accessiblegmbaccounts
Response:
200 OK
{
"kind": "content#liasettingsGetAccessibleGmbAccountsResponse",
"accountId": 67890,
"gmbAccounts": [{
"type" : "user",
"email" : "admin@example.com",
"name" : "admin@example.com",
"listingCount": 82
},
{
"type" : "business",
"email" : "california@example.com",
"name" : "Golden-State",
"listingCount" : 20
},
{
"type" : "business",
"email" : "florida@example.com",
"name" : "Sunshine-State",
"listingCount" : 15
},
{
"type" : "business",
"email" : "newyork@example.com",
"name" : "Empire-State",
"listingCount" : 25
}]
}
Merchant Center アカウントのビジネス グループを指定する
ビジネス拠点グループの候補のリストが作成されたら、Merchant Center アカウントに関連付けられた Accounts
リソースの googleMyBusinessLink
フィールドを目的のビジネス拠点グループに設定する必要があります。たとえば、Merchant Center 67890 にカリフォルニア州に拠点を置くビジネスの商品が含まれる場合は、Accounts.update
を使用してその情報を設定できます。
PUT https://shoppingcontent.googleapis.com/content/v2/12345/accounts/67890
{
"googleMyBusinessLink" : {
"gmbEmail": "california@example.com"
}
}
Response:
200 OK
{
"kind": "content#account",
"id": 67890,
"googleMyBusinessLink" : {
"gmbEmail": "california@example.com",
"status" : "active"
}
}
googleMyBusinessLink
フィールドの設定には手動での確認は必要ないため、リンクのステータスはすぐに反映されます。
商品データと在庫データを登録する
Merchant Center がビジネス拠点グループに関連付けられたので、これらのビジネスのローカル商品とローカル商品在庫のデータを提供できます。この場合、オンライン商品と在庫データのアップロードに使用する products.insert
などのメソッドを使用します。products.insert
には、online
ではなく local
のチャネルを指定します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 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 its future.\u003c/p\u003e\n"],["\u003cp\u003eTo provide local inventory, you must first link your Merchant Center to your Business Profile.\u003c/p\u003e\n"],["\u003cp\u003eAccess to the Business Profile is requested via the \u003ccode\u003eliasettings.requestgmbaccess\u003c/code\u003e method and granted by the Business Profile administrator.\u003c/p\u003e\n"],["\u003cp\u003eAfter access is granted, you can specify the business group for your Merchant Center and submit local product and inventory data.\u003c/p\u003e\n"]]],["The Merchant API beta, a new version of the Content API for Shopping, is introduced. To provide local inventory, first request Business Profile access via the `liasettings.requestgmbaccess` method, specifying the administrator's email. Once granted, use `liasettings.getaccessiblegmbaccounts` to list available business groups. Associate the Merchant Center account with a business group by setting the `googleMyBusinessLink` field via `Accounts.update`. Finally, submit local product and inventory data using methods like `products.insert`, specifying the \"local\" channel.\n"],null,["# Link your Business Profile\n\nTo provide local inventory to the Merchant Center, you must first specify which\nbusinesses the Merchant Center will be responsible for. You can get the list of\npossible business groups from the Business Profile via the Content API, but you'll need\nto request access to the Business Profile first.\n\nRequest access to a Business Profile\n------------------------------------\n\nTo request access to your Business Profile, use the\n[`liasettings.requestgmbaccess`](/shopping-content/reference/rest/v2.1/liasettings/requestgmbaccess)\nmethod: \n\n POST https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890/requestgmbaccess?gmbEmail=admin@example.com\n\nAs this example shows, the `gmbEmail` query parameter specifies the email\naddress of the administrator for the Business Profile.\n\nAfter you call this method, the specified administrator will receive an email\nasking them to accept or reject the access request. This request expires after\n7 days if no action is taken by the administrator.\n\nList the available business groups\n----------------------------------\n\nOnce access has been permitted, you can see which businesses are available by\ncalling the\n[`liasettings.getaccessiblegmbaccounts`](/shopping-content/reference/rest/v2.1/liasettings/getaccessiblegmbaccounts)\nmethod: \n\n GET https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890/accessiblegmbaccounts\n\n Response:\n 200 OK\n {\n \"kind\": \"content#liasettingsGetAccessibleGmbAccountsResponse\",\n \"accountId\": 67890,\n \"gmbAccounts\": [{\n \"type\" : \"user\",\n \"email\" : \"admin@example.com\",\n \"name\" : \"admin@example.com\",\n \"listingCount\": 82\n },\n {\n \"type\" : \"business\",\n \"email\" : \"california@example.com\",\n \"name\" : \"Golden-State\",\n \"listingCount\" : 20\n },\n {\n \"type\" : \"business\",\n \"email\" : \"florida@example.com\",\n \"name\" : \"Sunshine-State\",\n \"listingCount\" : 15\n },\n {\n \"type\" : \"business\",\n \"email\" : \"newyork@example.com\",\n \"name\" : \"Empire-State\",\n \"listingCount\" : 25\n }]\n }\n\nSpecify the business group for the Merchant Center account\n----------------------------------------------------------\n\nNow that you have a list of possible business groups, you need to set the\n`googleMyBusinessLink` field in the\n[`Accounts`](/shopping-content/reference/rest/v2.1/accounts) resource associated\nwith the Merchant Center account to the desired one. For example, if Merchant\nCenter 67890 will contain products for California-based businesses, you can use\n[`Accounts.update`](/shopping-content/reference/rest/v2.1/accounts/update) to set that\ninformation: \n\n PUT https://shoppingcontent.googleapis.com/content/v2/12345/accounts/67890\n {\n \"googleMyBusinessLink\" : {\n \"gmbEmail\": \"california@example.com\"\n }\n }\n\n Response:\n 200 OK\n {\n \"kind\": \"content#account\",\n \"id\": 67890,\n \"googleMyBusinessLink\" : {\n \"gmbEmail\": \"california@example.com\",\n \"status\" : \"active\"\n }\n }\n\nSetting the `googleMyBusinessLink` field does not require any manual\nverification, so the status of the link will be reflected immediately.\n\nSubmit product and inventory data\n---------------------------------\n\nNow that the Merchant Center is associated with a business group, you can\nprovide local product and local product inventory data for those businesses.\nFor this, you use the same methods, such as\n[`products.insert`](/shopping-content/reference/rest/v2.1/products/insert) that you\nuse to upload online products and inventory data.\nFor `products.insert`, you'll specify a channel of `local` instead of `online`.\n| **Note:** There are separate requirements for [local product feeds](https://support.google.com/merchants/answer/3061198) and [local product inventory feeds](https://support.google.com/merchants/answer/3061342), so make sure you're providing all the necessary information."]]