오프라인 제품 피드 파트너 이전

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} parentaccounts/{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} nameaccounts/{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} nameaccounts/{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} parentaccounts/{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 필드는 필수 항목입니다.

price: {

object (Price)

}

price: {

object (Price)

}

가격 정의가 변경되었습니다. 자세한 내용은 가격을 참고하세요.
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로 이름이 변경되었습니다.

price: {

object (Price)

}

price: {

object (Price)

}

가격 정의가 변경되었습니다. 자세한 내용은 가격을 참고하세요.
timestamp: string saleTime: string timestamp에서 saleTime로 이름이 변경되었습니다.
kind: string 지원되지 않음 kind는 오프라인 피드 파트너십 API에서 지원되지 않습니다.