rocket
隆重推出
Merchant API - Content API for Shopping 的正式替代方案。
update
获取最新资讯,了解 Merchant API 的新功能、问题修复和更新。
add_alert
注意:Content API for Shopping 将于 2026 年 8 月 18 日停用。
配置目标国家/地区
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
您可以使用 liasettings
服务管理与 LIA 相关的设置。
调用 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
,您必须解决与“关于”页面相关的问题。解决了所有问题后,您可以使用“关于”页面的位置(无论其是否有变化)来更新 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 提供的网址。在出现问题时,检查验证情况和/或申请再次审核政策网址的过程与“关于”页面中的流程相同:
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 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-13。
[null,null,["最后更新时间 (UTC):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 }"]]