오프라인 제품 피드 파트너 API

오프라인 제품 피드 파트너 프로그램을 이용하면 소매업체가 자체 기본 피드 및 오프라인 제품 인벤토리 피드를 만들지 않고 오프라인 판매점 인벤토리 광고와 무료 오프라인 제품 등록정보에 참여할 수 있습니다. 소매업체는 판매 및 인벤토리 정보를 Google과 공유할 수 있는 신뢰할 수 있는 데이터 제공업체에 해당 정보를 제공할 수 있습니다. 지원되는 데이터 파트너 목록은 오프라인 제품 피드 파트너 프로그램 정보를 참고하세요.

오프라인 제품 인벤토리 피드를 업로드하여 오프라인 제품 인벤토리를 추가할 수 있습니다.

인벤토리 데이터 제공업체를 판매자 센터에 추가하려면 Google에 오프라인 제품을 표시하기 위한 판매 시점 데이터 제공업체 의견에서 세부정보를 입력하세요.

Content API for Shopping에서의 이전에 대해 자세히 알아보려면 오프라인 피드 파트너십 이전을 참고하세요.

소매업체의 온보딩 상태 가져오기

GetLfpState 메서드를 사용하여 오프라인 피드 파트너십 통합과 관련된 판매자 수준 속성의 상태를 가져올 수 있습니다. 제공된 속성을 토대로 통합이 의도한 대로 작동하는지 또는 추가 조치가 필요한지 확인할 수 있습니다.

GET https://merchantapi.googleapis.com/lfp/v1beta/accounts/{ACCOUNT_ID}/lfpState/{TARGET_MERCHANT_ID}

인벤토리 삽입

인벤토리를 삽입하려면 다음 요청을 사용하세요.

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert

{
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "{OFFER_ID}",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "regionCode": "US",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

다음과 같은 응답이 표시됩니다.

{
 "name": "accounts/{merchantId}/lfpInventories/{TARGETMERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "{OFFER_ID}",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "feedLabel": "US"
}

자세한 내용은 메서드: accounts.lfpInventories.insert를 참고하세요.

할인 삽입

할인을 삽입하려면 다음 요청을 사용합니다.

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert

{
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "offerId",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": 2,
 "regionCode": "US",
 "saleTime": "2024-01-08T08:00:00Z",
 "storeCode": "123",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

다음과 같은 응답이 표시됩니다.

{
 "name": "accounts/1000005718521947/lfpSales/{UUID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "offerId",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": "2",
 "saleTime": "2024-01-08T08:00:00Z",
 "uid": "{UUID}",
 "feedLabel": "US"
}

자세한 내용은 메서드: accounts.lfpSales.insert를 참고하세요.

매장 삽입

매장을 삽입하려면 다음 요청을 사용합니다.

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

다음과 같은 응답이 표시됩니다.

{
 "name": "accounts/{MERCHANT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "1000005718454644",
 "storeCode": "{STORE_CODE}",
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "matchingState": "STORE_MATCHING_STATE_MATCHED"
}

자세한 내용은 메서드: accounts.lfpStores.insert를 참고하세요.

소매업체에 알림 보내기

SendLfpNotification 메서드를 사용하여 소매업체에 알림을 보낼 수 있습니다. 예를 들어 이 메서드를 사용하여 소매업체에 온보딩 알림을 보낼 수 있습니다.

POST https://merchantapi.googleapis.com/lfp/v1beta/accounts/{accountId}/lfpNotifications:send

{
  "target_account": {targetMerchantId},
  "email_address": {emailAddress},
  "type": {Type}
}

다음을 바꿉니다.

  • {accountId}: 판매자 센터 계정의 고유 식별자입니다.
  • {targetMerchantId}: 알림을 전송하려는 계정의 고유 식별자
  • {emailAddress}: 알림을 보내려는 계정의 이메일 주소입니다.
  • {Type}: 이 필드에서는 문자열 값 ONBOARDING_UI만 전달할 수 있습니다.