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