Merchant API를 사용하면 Google과 인벤토리, 매장, 판매 데이터를 공유하여 가시성과 관리 효율성을 높일 수 있습니다.
새로운 기능
Content API 기능 외에도 Merchant API는 다음과 같은 새로운 기능을 제공합니다.
- 오프라인 피드 파트너십 통합과 관련된 비즈니스 수준 속성의 상태를 가져오는 메서드
- 제휴사에 알림을 전송하는 메서드
이러한 메서드에 관한 자세한 내용은 오프라인 피드 파트너십 API를 참고하세요.
요청
오프라인 피드 파트너십 API에 다음 요청 URL 형식을 사용하세요.
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
자세한 내용은 메서드: accounts.lfpInventories.insert를 참고하세요.
다음은 인벤토리를 삽입하는 요청에 대한 Content API for Shopping과 오프라인 피드 파트너십 API의 샘플 비교입니다.
| Content API | Merchant API | |
| URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
|
| 식별자 |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}
|
{PARENT} |
다음은 판매를 삽입하는 요청에 대한 Content API for Shopping과 오프라인 피드 파트너십 API의 샘플 비교입니다.
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
| 식별자 | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
다음은 매장을 삽입하는 요청에 대한 Content API for Shopping과 오프라인 피드 파트너십 API의 샘플 비교입니다.
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpStores:insert |
| 식별자 | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
메서드
오프라인 피드 파트너십 API의 매장 API 메서드에서 변경된 사항은 다음과 같습니다.
| 메서드 | Content API for Shopping의 URL | Merchant API의 URL | Content API for Shopping의 식별자 | Merchant API의 식별자 | 설명 |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent는 accounts/{IFP_PARTNER_ACCOUNT_ID} 형식입니다. |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
DELETE https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name은 accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}의 형식입니다. |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
GET https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name은 accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}의 형식입니다. |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
GET https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores |
/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT}는 accounts/{IFP_PARTNER_ACCOUNT_ID} |
오프라인 피드 파트너십 API의 인벤토리 API 메서드에서 변경된 사항은 다음과 같습니다.
| 메서드 | Content API for Shopping의 URL | Merchant API의 URL | Content API for Shopping의 식별자 | Merchant API의 식별자 | 설명 |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent는 accounts/{IFP_PARTNER_ACCOUNT_ID} |
오프라인 피드 파트너십 API의 판매 API 메서드에서 변경된 사항은 다음과 같습니다.
| 메서드 | Content API for Shopping의 URL | Merchant API의 URL | Content API for Shopping의 식별자 | Merchant API의 식별자 | 설명 |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT}는 accounts/{IFP_PARTNER_ACCOUNT_ID} |
리소스
오프라인 피드 파트너십 API의 매장 리소스에서 변경된 사항은 다음과 같습니다. 여기에 포함되지 않은 필드는 변경되지 않습니다.
| Content API for Shopping | Merchant API | 설명 |
| 지원되지 않음 | name: string |
서로 다른 매장을 구분하기 위해 새 필드가 추가되었습니다. |
| 지원되지 않음 | targetAccount: integer |
인벤토리를 삽입할 판매자 센터 계정 |
targetCountry: string |
regionCode: string |
targetCountry의 이름이 regionCode로 변경되었습니다. |
websiteUrl: string |
websiteUri: string |
websiteUrl의 이름이 websiteUri로 변경되었습니다. |
kind: string |
지원되지 않음 | kind는 오프라인 피드 파트너십 API에서 지원되지 않습니다. |
인벤토리 삽입에 변경된 사항은 다음과 같습니다. 여기에 포함되지 않은 필드는 변경되지 않습니다.
| Content API for Shopping | Merchant API | 설명 |
| 지원되지 않음 | name: string |
서로 다른 인벤토리를 구분하기 위해 새 필드가 추가되었습니다. |
| 지원되지 않음 | targetAccount: integer |
인벤토리를 삽입할 판매자 센터 계정 |
targetCountry: string |
regionCode: string |
targetCountry의 이름이 regionCode로 변경되었습니다. 제품이 판매되는 국가의 CLDR 지역 코드 |
itemId: string |
offerId: string |
itemId의 이름이 offerId로 변경되었습니다. |
quantity: string |
quantity: string |
quantity가 선택사항으로 업데이트되었습니다. |
| 지원되지 않음 | availability: string |
availability는 필수 항목입니다. |
|
|
가격 정의가 변경되었습니다. 자세한 내용은 가격을 참고하세요. |
timestamp: string |
collectionTime: string |
timestamp의 이름이 collectionTime으로 변경되었습니다. |
kind: string |
지원되지 않음 | kind는 오프라인 피드 파트너십 API에서 지원되지 않습니다. |
판매 삽입에 변경된 사항은 다음과 같습니다. 여기에 포함되지 않은 필드는 변경되지 않습니다.
| Content API for Shopping | Merchant API | 설명 |
| 지원되지 않음 | name: string |
서로 다른 인벤토리를 구분하기 위해 새 필드가 추가되었습니다. |
| 지원되지 않음 | targetAccount:integer |
판매를 삽입할 판매자 센터 계정 |
targetCountry: string |
regionCode: string |
제품이 판매되는 국가의 CLDR 지역 코드 |
itemId: string |
offerId: string |
itemId의 이름이 offerId로 변경되었습니다. |
|
|
가격 정의가 변경되었습니다. 자세한 내용은 가격을 참고하세요. |
timestamp: string |
saleTime: string |
timestamp의 이름이 saleTime으로 변경되었습니다. |
kind: string |
지원되지 않음 | kind는 오프라인 피드 파트너십 API에서 지원되지 않습니다. |