rocket
Content API for Shopping の正式な後継である
Merchant API をご紹介します。
update
Merchant API の新機能、バグの修正、更新に関する
最新情報を入手してください。
add_alert
注: Content API for Shopping は 2026 年 8 月 18 日に廃止されます。
対象国の設定
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
LIA 関連の設定は、liasettings
サービスで管理できます。
liasettings.update
を呼び出して、ローカル在庫広告を配信する予定の国を指定します。次の例をご覧ください。
PUT https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890
{
"accountId" : 67890,
"countrySettings" : [{
"country" : "US"
}]
}
概要ページ
オーストリア、ドイツ、スイスでサービスを提供している場合は、概要ページも登録する必要があります。たとえば、米国とドイツで配信するために、次のような情報を送信できます。
PUT https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890
{
"accountId" : 67890,
"countrySettings" : [{
"country" : "US"
},
{
"country" : "DE",
"about" : {
"url" : "https://www.example.com/de/about"
}
}]
}
この URL の所有権が確認されるまで、在庫確認をリクエストすることはできません。URL の確認ステータスを確認するには、liasettings.get
を使用してアカウントの LIA 設定を取得し、関連するステータス フィールドの値を確認します。
GET https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890
Response:
200 OK
{
"kind": "content#liaSettings",
"accountId" : 67890,
"countrySettings" : [{
"country" : "US"
},
{
"country" : "DE",
"about" : {
"url" : "https://www.example.com/de/about",
"status" : "pending"
}
}]
}
URL に関連付けられたステータスが active
に変わると、URL が確認されます。ステータスが inactive
の場合、概要ページで対応する必要がある問題があります。問題に対処したら、[概要] ページの場所(同じか変更されたか)で LIA 設定を更新して、新しい審査をトリガーできます。
見本展示あり商品と店舗注文に関するポリシーページ
見本展示あり(ODO)機能を使用する場合は、国ごとに設定する必要があります。
PUT https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890
{
"accountId" : 67890,
"countrySettings" : [{
"country" : "US",
"onDisplayToOrder": {
"shippingCostPolicyUrl" : "https://www.example.com/inStoreOrderPolicy"
}
}]
}
ODO に指定する URL は、在庫確認をリクエストする前に確認する必要があります。問題が発生した場合に、ポリシー URL の確認や再審査をリクエストするプロセスは、[概要] ページと同じフローで行われます。
GET https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890
Response:
200 OK
{
"kind": "content#liaSettings",
"accountId" : 67890,
"countrySettings" : [{
"country" : "US",
"onDisplayToOrder": {
"shippingCostPolicyUrl" : "https://www.example.com/inStoreOrderPolicy",
"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\u003eYou can manage Local Inventory Ads (LIA) settings, including country targeting and About page submission, using the \u003ccode\u003eliasettings\u003c/code\u003e service.\u003c/p\u003e\n"],["\u003cp\u003eFor countries like Austria, Germany, and Switzerland, an About page submission is required for serving LIAs and must be verified before inventory verification can be requested.\u003c/p\u003e\n"],["\u003cp\u003eOn Display to Order (ODO) feature requires a country-specific setup, including a verified shipping cost policy URL, before inventory verification.\u003c/p\u003e\n"],["\u003cp\u003eVerification status for both About pages and ODO policy URLs can be retrieved using the \u003ccode\u003eliasettings.get\u003c/code\u003e method, and updates or re-reviews can be triggered by modifying the LIA settings.\u003c/p\u003e\n"]]],["The Merchant API's beta version is introduced as the successor to the Content API for Shopping. Using the `liasettings` service, users can manage settings for local inventory ads (LIA). This involves specifying target countries via `liasettings.update` and submitting an \"About page\" URL for Austria, Germany, or Switzerland. The `liasettings.get` method allows checking the URL verification status. The \"on display to order\" (ODO) feature can be enabled per country with a verified policy URL.\n"],null,["# Configure target countries\n\nYou can manage LIA-related settings with the\n[`liasettings`](/shopping-content/reference/rest/v2.1/liasettings) service.\n\nCall [`liasettings.update`](/shopping-content/reference/rest/v2.1/liasettings/update) to specify the countries where you plan to serve local inventory ads. Here's an example: \n\n PUT https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890\n {\n \"accountId\" : 67890,\n \"countrySettings\" : [{\n \"country\" : \"US\"\n }]\n }\n\nAbout pages\n-----------\n\nIf you're serving in Austria, Germany, or Switzerland, you must also [submit an About page](https://support.google.com/merchants/answer/7455784). For example, you might submit the following information to serve in the US and Germany: \n\n PUT https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890\n {\n \"accountId\" : 67890,\n \"countrySettings\" : [{\n \"country\" : \"US\"\n },\n {\n \"country\" : \"DE\",\n \"about\" : {\n \"url\" : \"https://www.example.com/de/about\"\n }\n }]\n }\n\nUntil this URL is verified, inventory verification cannot be requested. To see\nthe URL verification status, retrieve the account's LIA settings via\n[`liasettings.get`](/shopping-content/reference/rest/v2.1/liasettings/get) and check\nthe value of the associated status field: \n\n GET https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890\n\n Response:\n 200 OK\n {\n \"kind\": \"content#liaSettings\",\n \"accountId\" : 67890,\n \"countrySettings\" : [{\n \"country\" : \"US\"\n },\n {\n \"country\" : \"DE\",\n \"about\" : {\n \"url\" : \"https://www.example.com/de/about\",\n \"status\" : \"pending\"\n }\n }]\n }\n\nOnce the status associated with the URL changes to `active`, the URL is\nverified. If the status is `inactive`, then there are issues you must address\nwith your About page. Once you've addressed any issues, you can trigger a new\nreview by either updating your LIA\nsettings with the location of the About page, whether it is the same or has\nchanged.\n\nOn display to order and in-store order policy pages\n---------------------------------------------------\n\nIf you want to use the\n[on display to order](https://support.google.com/merchants/answer/7029575) (ODO)\nfeature, then you should also set that up on a per-country basis: \n\n PUT https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890\n {\n \"accountId\" : 67890,\n \"countrySettings\" : [{\n \"country\" : \"US\",\n \"onDisplayToOrder\": {\n \"shippingCostPolicyUrl\" : \"https://www.example.com/inStoreOrderPolicy\"\n }\n }]\n }\n\nNote that the URL you provide for ODO must be verified *before* you request\ninventory verification. The process for checking verification and/or requesting\nanother review of the policy URL in the case of issues follows the same flow as\nthe About page: \n\n GET https://shoppingcontent.googleapis.com/content/v2.1/12345/liasettings/67890\n\n Response:\n 200 OK\n {\n \"kind\": \"content#liaSettings\",\n \"accountId\" : 67890,\n \"countrySettings\" : [{\n \"country\" : \"US\",\n \"onDisplayToOrder\": {\n \"shippingCostPolicyUrl\" : \"https://www.example.com/inStoreOrderPolicy\",\n \"status\" : \"pending\"\n }\n }]\n }"]]