Merchant API를 사용하여 오프라인 (매장) 및 지역별 인벤토리를 관리할 수 있습니다.
요청
Inventories 하위 API에 다음 요청 URL 형식을 사용합니다.
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories
판매자 API에서는 인벤토리 하위 API와 관련 엔드포인트를 복수형 '인벤토리'라고 부릅니다.
다음은 오프라인 판매점 인벤토리 요청에 대한 Content API for Shopping과 판매자 인벤토리 API를 비교한 예시입니다.
| Content API | 판매자 API | |
|---|---|---|
| URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}/localinventory | https://merchantapi.googleapis.com/inventories/v1beta/{parent}/localInventories |
| 식별자 | {merchantId}/products/{productId} |
{name}
|
방법
Merchant API에는 인벤토리 관리를 위한 두 가지 새로운 방법이 도입되었습니다.
- 제품의 오프라인 및 지역별 인벤토리를 나열합니다.
- 제품에서 오프라인 및 지역 인벤토리를 삭제합니다.
다음은 Content API for Shopping과 판매자 인벤토리 API의 인벤토리 메서드를 비교한 것입니다.
| 메서드 | Content API for Shopping | 판매자 API |
|---|---|---|
customBatch |
지원됨 | No |
insert |
지원됨 | 지원됨 |
list |
No | 예 |
delete |
No | 지원됨 |
오프라인 판매점 인벤토리
Merchant Inventories API의 오프라인 판매점 인벤토리에 대한 변경사항은 다음과 같습니다.
| Content API for Shopping | 판매자 API | 설명 |
|---|---|---|
| 지원되지 않음 | name:string
|
product 내의 LocalInventory 리소스를 구분하기 위한 새 필드를 추가했습니다. Content API for Shopping은 storeCode 및 productId로 오프라인 판매점 인벤토리를 식별합니다.
|
| 지원되지 않음 | account:string
|
product 및 LocalInventory가 속한 판매자 계정을 식별하기 위한 새 필드가 추가되었습니다.
|
price: {
|
price: {
|
Price 정의가 변경되었습니다.
|
salePrice: {
|
salePrice: {
|
Price 정의가 변경되었습니다.
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate는 판매자 인벤토리 API에서 새로운 TimePeriod 유형을 사용합니다.
|
quantity:string,
|
quantity:integer
|
quantity는 판매자 인벤토리 API에서 문자열 대신 정수를 사용합니다.
|
kind:string
|
지원되지 않음 | 판매자 인벤토리 API에서는 kind가 지원되지 않습니다.
|
| 지원되지 않음 | localShippingLabel:string
|
판매자 인벤토리 API에서 오프라인 배송 서비스에 라벨을 지정하는 새 필드를 추가했습니다. |
지역 인벤토리
Merchant Inventories API의 지역 인벤토리에 대한 변경사항은 다음과 같습니다.
| Content API for Shopping | 판매자 API | 설명 |
|---|---|---|
| 지원되지 않음 | name:string
|
product 내의 regionalInventory 리소스를 구분하기 위한 새 필드를 추가했습니다. Content API for Shopping은 regionId 및 productId로 지역 인벤토리를 식별합니다.
|
| 지원되지 않음 | account:string
|
product 및 regionalInventory가 속한 판매자 계정을 식별하기 위한 새 필드가 추가되었습니다.
|
"regionId": string
|
"region": string
|
regionID는 판매자 인벤토리 API에서 region라고 합니다.
|
price: {
|
price: {
|
Price 정의가 변경되었습니다.
|
salePrice: {
|
salePrice: {
|
Price 정의가 변경되었습니다.
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate는 판매자 인벤토리 API에서 새로운 TimePeriod 유형을 사용합니다.
|
kind:string
|
지원되지 않음 | 판매자 인벤토리 API에서는 kind가 지원되지 않습니다.
|