rocket
Content API for Shopping의 공식 후속 API인
Merchant API를 만나보세요.
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"
}
}]
}
이 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"
}
}]
}
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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 }"]]