오프라인 판매점 인벤토리 서비스를 사용하면 여러 오프라인 상점 위치에 대해 서로 다른 값을 가질 수 있는 필드가 포함된 오프라인 판매점 인벤토리 리소스의 인스턴스를 만들고 업데이트할 수 있습니다. 각 오프라인 판매점 인벤토리 인스턴스는 기존 제품 리소스의 하위 요소이며 상위 리소스에서 제품 데이터 필드를 상속합니다. 예를 들어 여러 매장의 가격과 수량은 다르지만 모든 매장에서 ID, 설명, 기타 제품 데이터를 공유하는 제품이 있을 수 있습니다. 오프라인 판매점 인벤토리 데이터는 Google 지역 플랫폼 및 오프라인 판매점 인벤토리 광고 프로그램에 사용됩니다.
이 가이드에서는 오프라인 판매점 인벤토리 서비스를 사용하기 전에 필요한 사항, 사용 가능한 필드 및 메서드, 서비스 요청의 예를 제공합니다.
기본 요건
- 오프라인 판매점 인벤토리 서비스를 사용하려면 비즈니스 프로필을 만들고 비즈니스 프로필을 판매자 센터 계정에 연결하고 비즈니스를 인증하고 비즈니스 프로필 판매점 코드를 설정해야 합니다.
판매자 센터 계정이 오프라인 프로그램(Google 지역 플랫폼 또는 오프라인 판매점 인벤토리 광고)에 등록되어 있어야 합니다. Content API를 통해 오프라인 판매점 인벤토리 광고를 사용하는 방법에 대한 자세한 내용은 오프라인 판매점 인벤토리 광고 시작하기를 참조하세요.
오프라인 판매점 인벤토리 서비스는 기존 오프라인 제품의 오프라인 판매점 인벤토리 인스턴스를 만듭니다. 먼저
channel필드를local로 설정하여 Content API 제품 서비스나 판매자 센터 데이터 피드를 사용하여 오프라인 제품을 만들어야 합니다. 그런 다음 오프라인 판매점 인벤토리 서비스를 사용하여 제품이 판매되는 각 비즈니스 프로필storecode의 오프라인 판매점 인벤토리 인스턴스를 만들 수 있습니다.
필드
각 오프라인 판매점 인벤토리 인스턴스에는 비즈니스 프로필에서 정의하는 storeCode 필드를 통해 특정 매장 위치와 연결된 일련의 필드가 포함됩니다. 모든 요청에는 storecode 및 productId만 필요합니다. 다른 모든 필드는 선택사항입니다.
- 모든 요청에 대해 필수:
storeCode,productId(URL) - 선택사항:
quantity,price,salePrice,salePriceEffectiveDate,availability,pickupMethod,pickupSla,instoreProductLocation
오프라인 판매점 인벤토리 필드의 전체 목록과 설명은 localinventory 참조 페이지를 확인하세요.
방법
오프라인 판매점 인벤토리 서비스에는 다음 두 가지 방법만 포함됩니다.
localinventory.insert
localinventory.insert를
사용하면 단일 오프라인 제품의 오프라인 판매점 인벤토리 인스턴스를 만들 수 있습니다.
이 예시에서는 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
{
"storeCode": “1235”,
"salePrice": {
"value": “100.00”,
"currency": “USD”
},
"salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
"quantity": 200,
}
localinventory.custombatch
localinventory.custombatch를
사용하면 여러 매장에서 단일 오프라인 제품에 대한
여러 개의 오프라인 판매점 인벤토리 인스턴스를 만들거나 여러 오프라인 제품에 대한
오프라인 판매점 인벤토리 인스턴스를 만들 수 있습니다.