판매자 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에서 지원되지 않습니다. |