rocket
隆重推出
Merchant API
- Content API for Shopping 的官方後繼產品。
update
掌握最新資訊
瞭解 Merchant API 的新功能、錯誤修正和更新。
add_alert
注意:Content API for Shopping 將於 2026 年 8 月 18 日停用。
設定指定國家/地區
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
你可以使用 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"
}
}]
}
您必須先驗證這個網址,才能申請商品目錄驗證。如要查看網址驗證狀態,請透過 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"
}
}]
}
網址的狀態變更為 active
後,即表示網址已通過驗證。如果狀態為 inactive
,表示「關於」頁面有問題,請務必解決。解決所有問題後,請更新店面商品資訊設定,提供「關於」頁面的位置 (無論是否與先前相同),即可觸發新的審查。
「可訂購的展示商品」和「店內訂購」政策頁面
如要使用可訂購的展示商品 (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 提供的網址必須先經過驗證,才能申請商品目錄驗證。如有問題,檢查驗證和/或要求再次審查政策網址的程序,與「關於」頁面相同:
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"
}
}]
}
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-13 (世界標準時間)。
[null,null,["上次更新時間:2025-08-13 (世界標準時間)。"],[[["\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 }"]]