Merchant API를 사용하여 인벤토리, 매장, 판매 데이터를 Google과 공유하여 가시성과 관리를 개선할 수 있습니다.
새로운 기능
Merchant API는 Content API 기능 외에도 다음과 같은 새로운 기능을 제공합니다.
- 로컬 피드 파트너십 통합과 관련된 판매자 수준 속성의 상태를 검색하는 메서드
- 소매업체에 알림을 전송하는 방법
이러한 메서드에 관한 자세한 내용은 오프라인 제품 피드 파트너십 API를 참고하세요.
요청
로컬 피드 파트너십 API에는 다음과 같은 요청 URL 형식을 사용합니다.
POST https://merchantapi.googleapis.com/lfp/v1beta/{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/v1beta/{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/v1beta/{PARENT}/lfpSales:insert |
| 식별자 | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
다음은 매장 삽입 요청에 관한 쇼핑용 Content API와 로컬 피드 파트너십 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/v1beta/{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/v1beta/{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/v1beta/{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/v1beta/{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/v1beta/{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/v1beta/{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/v1beta/{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에서 지원되지 않습니다. |