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

판매자 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} 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/v1/{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/v1/{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/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} 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/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 필드는 필수 항목입니다.

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