오프라인 인벤토리 서비스를 사용하면 여러 오프라인 매장 위치에 대해 값이 다를 수 있는 필드가 포함된 오프라인 인벤토리 리소스의 인스턴스를 만들고 업데이트할 수 있습니다. 각 오프라인 인벤토리 인스턴스는 기존 제품 리소스의 하위 요소이며 상위 리소스의 제품 데이터 필드를 상속합니다. 예를 들어 매장마다 가격과 수량이 다르지만 모든 매장에서 ID, 설명, 기타 제품 데이터를 공유하는 제품이 있을 수 있습니다. 오프라인 판매점 인벤토리 데이터는 지역 Google 플랫폼 및 오프라인 판매점 인벤토리 광고 프로그램에 사용됩니다.
이 가이드에서는 오프라인 매장 인벤토리 서비스를 사용하기 전에 필요한 사항을 설명하고, 사용 가능한 필드와 메서드를 설명하며, 서비스 요청의 예를 제공합니다.
판매자 센터 계정이 Google 지역 플랫폼 또는 오프라인 판매점 인벤토리 광고와 같은 오프라인 프로그램에 등록되어 있어야 합니다. 콘텐츠 API를 통해 오프라인 판매점 인벤토리 광고를 사용하는 방법에 관한 자세한 내용은 오프라인 판매점 인벤토리 광고 시작하기를 참고하세요.
오프라인 판매점 인벤토리 서비스는 기존 오프라인 제품의 오프라인 판매점 인벤토리 인스턴스를 만듭니다. 먼저 콘텐츠 API 제품 서비스 또는 판매자 센터 데이터 피드를 사용하여 channel 필드를 local로 설정하여 오프라인 제품을 만들어야 합니다. 그런 다음 오프라인 판매점 인벤토리 서비스를 사용하여 제품이 판매되는 각 비즈니스 프로필 storecode의 오프라인 판매점 인벤토리 인스턴스를 만들 수 있습니다.
필드
각 오프라인 인벤토리 인스턴스에는 storeCode 필드 (비즈니스 프로필에서 정의)를 통해 특정 매장 위치와 연결된 필드 집합이 포함되어 있습니다. 모든 요청에 storecode 및 productId만 필요합니다. 다른 모든 필드는 선택사항입니다.
이 예시에서는 2021년 2월 24일 오후 1시 (GMT-8)부터 2021년 2월 28일 오후 3시 30분(GMT-8)까지 오프라인 매장 인벤토리 서비스를 사용하여 오프라인 매장 할인을 만드는 방법을 보여줍니다. 이 요청은 오프라인 판매점 인벤토리 인스턴스에서 사용할 수 있는 수량도 업데이트합니다. 오프라인 제품 데이터의 보조 피드와 달리 요청 본문에 포함되지 않은 필드는 이 호출에 의해 덮어쓰여집니다.
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory
[null,null,["최종 업데이트: 2025-08-13(UTC)"],[[["\u003cp\u003eThe Merchant API beta is the new version of the Content API for Shopping, offering improvements and opportunities to shape its future.\u003c/p\u003e\n"],["\u003cp\u003eThe local inventory service enables management of product data specific to physical store locations, like price and quantity, used for Local surfaces across Google and Local Inventory Ads.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize the local inventory service, prerequisites include a linked and verified Business Profile, Merchant Center account enrollment in a local program, and pre-existing local products.\u003c/p\u003e\n"],["\u003cp\u003eThe service provides two methods: \u003ccode\u003elocalinventory.insert\u003c/code\u003e for creating single local inventory instances and \u003ccode\u003elocalinventory.custombatch\u003c/code\u003e for creating multiple instances across products or stores.\u003c/p\u003e\n"],["\u003cp\u003eWhile you can create and update local inventory, retrieving, listing, or deleting instances is not supported; viewing data is possible within Merchant Center's product details.\u003c/p\u003e\n"]]],["The Merchant API's beta version is introduced as the new Content API for Shopping. The local inventory service within the Merchant API allows creating and updating local inventory instances for physical store locations, linked to existing product resources. Prerequisites include setting up a Business Profile, linking it to Merchant Center, verifying the business, and enrolling in a local program. The service supports `localinventory.insert` to create a single instance and `localinventory.custombatch` for multiple instances and only `storeCode` and `productId` are required for all requests.\n"],null,["# Local inventory service\n\nThe local inventory service allows you to create and update instances of the\n[local inventory resource](/shopping-content/reference/rest/v2.1/localinventory#resource:-localinventory),\nwhich contain fields that can have different values\nfor different physical store locations. Each local inventory instance is a child\nof an existing [product resource](/shopping-content/reference/rest/v2.1/products#resource:-product),\nand inherits the product data fields from the\nparent resource. For example, you might have a product that has a different\nprice and quantity in different stores, but shares an ID, description, and other\nproduct data across all stores. Local inventory data is used for the\n[Local surfaces across Google](//support.google.com/merchants/answer/9825611)\nand [Local Inventory Ads](//support.google.com/merchants/answer/3057972)\nprograms.\n\nThis guide explains what you need before you start using the local inventory\nservice, describes the available fields and methods, and provides an example of\na service request.\n| **Note:** In v2.1 of the Content API, the local inventory service and supplemental feeds replace the inventory service in v2. To perform partial updates to non-local product data with API v2.1, use [supplemental feeds](/shopping-content/guides/products/supplemental-feeds). To make supplemental local product updates, use the [`localinventory`\n| service](/shopping-content/guides/products/local-inventory).\n\nPrerequisites\n-------------\n\n- In order to use the local inventory service, you must [create a Business Profile](//support.google.com/business/answer/6300717), [link your Business Profile to your Merchant Center account](/shopping-content/guides/how-tos/lia/link-gmb), [verify your business](//support.google.com/business/answer/6300716), and [set up your Business Profile store codes](//support.google.com/business/answer/4542487).\n- Your Merchant Center account must be enrolled in a local program: either\n **Local surfaces across Google** or **Local inventory ads** . For more\n information about using local inventory ads via the Content API, see\n [Get Started with Local Inventory Ads](/shopping-content/guides/how-tos/lia/get-started).\n\n | **Note:** If your Merchant Center account is not enrolled in a local program, setting a product's `channel` field to `local`, via the [`Products.insert`](/shopping-content/reference/rest/v2.1/products/insert) method, results in the error: \"\u003cvar translate=\"no\"\u003echannel\u003c/var\u003e Invalid channel: local\".\n- The local inventory service creates local inventory instances for existing\n local products You must first create local products, using either the Content\n API [products](/shopping-content/reference/rest/v2.1/products) service or\n Merchant Center [datafeeds](//support.google.com/merchants/answer/7439882), by\n setting the `channel` field to `local`. You can then use the local inventory\n service to create local inventory instances for each Business Profile\n `storecode` where the product is sold.\n\nFields\n------\n\nEach local inventory instance contains a set of fields that is associated with a\nspecific store location via the `storeCode` field (which you define in your\nBusiness Profile). Only\n[`storecode`](/shopping-content/reference/rest/v2.1/localinventory#LocalInventory.FIELDS.store_code)\nand\n[`productId`](/shopping-content/reference/rest/v2.1/products#Product.FIELDS.id)\nare required for all requests. All other fields are optional:\n\n- Required for all requests: `storeCode`, `productId` (in URL)\n- Optional: `quantity`, `price`, `salePrice`, `salePriceEffectiveDate`, `availability`, `pickupMethod`, `pickupSla`, `instoreProductLocation`\n\nFor a complete list of local inventory fields and their descriptions, see the\n[localinventory](/shopping-content/reference/rest/v2.1/localinventory) reference\npage.\n\nMethods\n-------\n\nThe local inventory service only includes two methods:\n\n### localinventory.insert\n\n[`localinventory.insert`](/shopping-content/reference/rest/v2.1/localinventory/insert)\nallows you to create a local inventory instance for a single local product.\n\nThis example demonstrates how to use the local inventory service to\n[create an in-store sale](//support.google.com/merchants/answer/9017019) from\nFebruary 24th, 2021 at 1:00 pm (GMT-8) until February 28th, 2021 at 3:30pm\n(GMT-8). The request also updates the quantity available for the local inventory\ninstance. Unlike\n[supplemental feeds](/shopping-content/guides/products/supplemental-feeds)\nfor non-local product data, fields that are not included in the body of the\nrequest are overwritten by this call: \n\n POST https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003emerchantId\u003c/var\u003e/products/\u003cvar translate=\"no\"\u003eproductId\u003c/var\u003e/localinventory\n\n {\n \"storeCode\": \"1235\",\n \"salePrice\": {\n \"value\": \"100.00\",\n \"currency\": \"USD\"\n },\n \"salePriceEffectiveDate\": \"2021-02-24T13:00-0800/2021-02-28T15:30-0800\",\n \"quantity\": 200,\n }\n\n### localinventory.custombatch\n\n[`localinventory.custombatch`](/shopping-content/reference/rest/v2.1/localinventory/custombatch)\nallows you to create multiple local inventory instances for a single\nlocal product in multiple stores, or create local inventory instances for\nmultiple local products.\n| **Note:** It is not possible to retrieve, list, or delete local inventory instances. To view local inventory data in Merchant Center, select a local product in the **All products** page and then expand the **Local inventory** section. The table displays the local inventory data for each store code."]]
