판매자 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에서 변경된 사항은 다음과 같습니다.
메서드 | 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 |
지원되지 않음 | 오프라인 매장 피드 파트너십 API에서 kind 이 지원되지 않음 |
인벤토리를 삽입할 때 변경된 사항은 다음과 같습니다. 여기에 포함되지 않은 필드는 변경되지 않습니다.
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에서 지원되지 않습니다. |