Merchant API를 사용하여 오프라인 (매장) 및 지역 인벤토리를 관리할 수 있습니다.
요청
Merchant Inventories API에 다음 요청 URL 형식을 사용합니다.
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/regionalInventories
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/localInventories
{PARENT}의 형식은 accounts/{ACCOUNT_ID}/products/ {PRODUCT_ID}입니다.
다음은 오프라인 인벤토리 요청의 샘플 비교입니다.
| 항목 | Content API for Shopping | Merchant API |
|---|---|---|
| URL | https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}/localinventory | https://merchantapi.googleapis.com/inventories/v1/{PARENT}/localInventories |
| 식별자 | {MERCHANT_ID}/products/{PRODUCT_ID} |
{NAME}
|
메서드
판매자 API에는 인벤토리 관리를 위한 두 가지 새로운 메서드가 도입되었습니다.
list: 제품의 지역 및 리전 인벤토리를 나열할 수 있습니다.delete: 제품의 지역 및 로컬 재고를 삭제할 수 있습니다.
다음은 인벤토리를 관리하는 데 사용할 수 있는 방법을 비교한 것입니다.
| 메서드 | Content API for Shopping | Merchant API |
|---|---|---|
customBatch |
예 | 아니요 |
insert |
예 | 예 |
list |
아니요 | 예 |
delete |
아니요 | 예 |
리소스
지역 및 리전 인벤토리의 변경사항은 다음과 같습니다.
| Content API for Shopping | Merchant API | 설명 |
|---|---|---|
| 지원되지 않음 | name:string
|
이 필드는 product 내에서 LocalInventory 및 RegionalInventory 리소스를 구분합니다. Content API for Shopping은 storeCode 및 productId로 오프라인 판매점 인벤토리를 식별하고 regionId 및 productId로 지역 인벤토리를 식별합니다.
|
| 지원되지 않음 | account:string
|
product 및 LocalInventory이 속한 판매자 센터 계정을 식별하는 새 필드가 추가되었습니다.
|
price: {
object (Price)
}
|
price: {
|
Price 정의가 변경되었습니다.
|
salePrice: {
|
salePrice: {
|
Price 정의가 변경되었습니다.
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate는 판매자 인벤토리 API에서 새로운 TimePeriod 객체를 사용합니다.
|
kind:string
|
지원되지 않음 | API는 kind을 지원하지 않습니다.
|
quantity:string
|
quantity:integer
|
quantity는 오프라인 판매점 인벤토리에서 문자열 대신 정수를 사용합니다.
|
| 지원되지 않음 | localShippingLabel:string
|
product 및 regionalInventory이 속한 판매자 센터 계정을 식별하는 새 필드가 추가되었습니다.
|
"regionId": string
|
"region": string
|
이제 regionID은 지역 인벤토리의 region이라고 합니다.
|
정의된 값 집합이 있는 string 유형 필드
|
정의된 값 집합이 있는 enum 유형 필드
|
정의된 값 집합이 있는 인벤토리 속성의 필드 (예: availability, pickupMethod)가 이제 enum 유형입니다.
|