Package google.shopping.merchant.lfp.v1beta

색인

LfpInventoryService

LFP 파트너가 판매자의 오프라인 인벤토리를 제출할 수 있는 서비스입니다.

InsertLfpInventory

rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory)

지정된 대상 판매자 계정의 LfpInventory 리소스를 삽입합니다. 리소스가 이미 있으면 대체됩니다. 인벤토리는 30일 후에 자동으로 만료됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.

LfpSaleService

LFP 파트너가 판매자의 판매 데이터를 제출할 수 있는 서비스입니다.

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

지정된 판매자의 LfpSale를 삽입합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.

LfpStoreService

LFP 파트너가 판매자의 오프라인 상점을 제출하는 서비스입니다.

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

대상 판매자의 매장을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.

GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

매장에 대한 정보를 검색합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.

InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

대상 판매자의 매장을 삽입합니다. 상점 코드가 동일한 매장이 이미 있는 경우 대체됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

ListLfpStoresRequest의 필터에 지정된 대상 판매자의 매장을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DeleteLfpStoreRequest

DeleteLfpStore 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 대상 판매자 계정에 대해 삭제할 매장의 이름입니다. 형식: accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

GetLfpStore 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 매장의 이름입니다. 형식: accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

InsertLfpInventory 메서드에 대한 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. LFP 제공업체 계정입니다. 형식: accounts/{account}

lfp_inventory

LfpInventory

필수 항목입니다. 삽입할 인벤토리입니다.

InsertLfpSaleRequest

InsertLfpSale 메서드 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. LFP 제공업체 계정입니다. 형식: accounts/{lfp_partner}

lfp_sale

LfpSale

필수 항목입니다. 삽입할 판매입니다.

InsertLfpStoreRequest

InsertLfpStore 메서드 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. LFP 제공업체 계정 형식: accounts/{account}

lfp_store

LfpStore

필수 항목입니다. 삽입할 스토어입니다.

LfpInventory

판매자를 위한 오프라인 판매점 인벤토리입니다.

입력란
name

string

출력 전용입니다. 식별자. LfpInventory 리소스의 이름입니다. 형식: accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}

target_account

int64

필수 항목입니다. 인벤토리를 제출할 판매자의 판매자 센터 ID입니다.

store_code

string

필수 항목입니다. 판매자 매장의 식별자입니다. InsertLfpStore를 통해 삽입된 판매점 코드 또는 비즈니스 프로필의 판매점 코드입니다.

offer_id

string

필수 항목입니다. 변경할 수 없습니다. 제품의 고유 식별자입니다. 판매자에 대해 인벤토리와 판매를 모두 제출하는 경우 이 ID는 동일한 제품과 일치해야 합니다.

참고: 판매자가 동일한 제품을 새 상품 및 중고품으로 판매하는 경우 서로 다른 ID를 사용해야 합니다.

region_code

string

필수 항목입니다. 제품이 판매되는 국가의 CLDR 지역 코드입니다.

content_language

string

필수 항목입니다. 상품의 두 자리 ISO 639-1 언어 코드입니다.

price

Price

선택사항입니다. 제품의 현재 가격입니다.

availability

string

필수 항목입니다. 이 매장의 제품 재고입니다. 허용되는 속성 값은 오프라인 제품 인벤토리 데이터 사양을 참조하세요.

collection_time

Timestamp

선택사항입니다. 인벤토리가 수집되는 시간입니다. 설정하지 않으면 인벤토리가 제출된 시간으로 설정됩니다.

gtin

string

선택사항입니다. 제품의 국제거래단품식별코드입니다.

quantity

int64

선택사항입니다. 이 매장에서 구매할 수 있는 제품의 수량입니다. 0 이상이어야 합니다.

pickup_method

string

선택사항입니다. 이 상품에 지원되는 수령 방법입니다. 값이 '지원되지 않음'이 아닌 경우 이 필드는 pickupSla와 함께 제출해야 합니다. 허용되는 속성 값은 오프라인 제품 인벤토리 데이터 사양을 참조하세요.

pickup_sla

string

선택사항입니다. 주문 날짜를 기준으로 주문 상품 수령이 가능할 것으로 예상되는 날짜입니다. pickupMethod와 함께 제출해야 합니다. 허용되는 속성 값은 오프라인 제품 인벤토리 데이터 사양을 참조하세요.

feed_label

string

선택사항입니다. 제품의 피드 라벨입니다. 설정하지 않으면 기본값은 regionCode입니다.

LfpSale

판매자의 판매입니다.

입력란
name

string

출력 전용입니다. 식별자. LfpSale 리소스 이름입니다. 형식: accounts/{account}/lfpSales/{sale}

target_account

int64

필수 항목입니다. 할인을 제출할 판매자의 판매자 센터 ID입니다.

store_code

string

필수 항목입니다. 판매자 매장의 식별자입니다. API를 통해 삽입된 storeCode 또는 비즈니스 프로필의 매장 코드 중 하나입니다.

offer_id

string

필수 항목입니다. 제품의 고유 식별자입니다. 판매자에 대해 인벤토리와 판매를 모두 제출하는 경우 이 ID는 동일한 제품과 일치해야 합니다.

참고: 판매자가 동일한 제품을 새 상품 및 중고품으로 판매하는 경우 서로 다른 ID를 사용해야 합니다.

region_code

string

필수 항목입니다. 제품이 판매되는 국가의 CLDR 지역 코드입니다.

content_language

string

필수 항목입니다. 상품의 두 자리 ISO 639-1 언어 코드입니다.

gtin

string

필수 항목입니다. 판매된 제품의 국제거래단품식별코드입니다.

price

Price

필수 항목입니다. 제품의 단가입니다.

quantity

int64

필수 항목입니다. 재고량의 상대적 변화입니다. 반환된 항목의 경우 음수입니다.

sale_time

Timestamp

필수 항목입니다. 할인의 타임스탬프입니다.

uid

string

출력 전용입니다. 시스템에서 생성된 LfpSale의 전역 고유 ID입니다.

feed_label

string

선택사항입니다. 제품의 피드 라벨입니다. 설정하지 않으면 기본값은 regionCode입니다.

LfpStore

판매자의 매장입니다. 이 정보는 대상 판매자의 Google 비즈니스 프로필에 있는 매장과 일치시키는 데 사용됩니다. 일치하는 매장을 찾을 수 없는 경우 판매점 코드와 함께 제출된 인벤토리 또는 판매가 사용되지 않습니다.

입력란
name

string

출력 전용입니다. 식별자. LfpStore 리소스 이름입니다. 형식: accounts/{account}/lfpStores/{target_merchant}~{store_code}

target_account

int64

필수 항목입니다. 매장을 제출할 판매자의 판매자 센터 ID입니다.

store_code

string

필수 항목입니다. 변경할 수 없습니다. 대상 판매자의 고유한 매장 식별자입니다.

store_address

string

필수 항목입니다. 매장의 상세 주소입니다. 예: 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA.

gcid_category[]

string

선택사항입니다. Google 마이 비즈니스 카테고리 ID입니다.

matching_state

StoreMatchingState

선택사항입니다. 출력 전용입니다. Google 비즈니스 프로필과의 일치 상태입니다. 일치하는 항목이 없는 경우 자세한 내용은 matchingStateHint를 참고하세요.

store_name

string

선택사항입니다. 판매자 또는 매장 이름입니다.

phone_number

string

선택사항입니다. E.164 형식의 매장 전화번호입니다. 예: +15556767888

website_uri

string

선택사항입니다. 매장 또는 판매자의 웹사이트 URL입니다.

place_id

string

선택사항입니다. 매장 위치의 Google Place Id입니다.

matching_state_hint

string

선택사항입니다. 출력 전용입니다. 일치가 실패한 이유에 대한 힌트입니다. matchingState=STORE_MATCHING_STATE_FAILED인 경우에만 설정됩니다.

가능한 값은 다음과 같습니다.

  • "linked-store-not-found": 일치시킬 수 있는 Google 비즈니스 프로필 매장이 없습니다.
  • "store-match-not-found": 제공된 LfpStore이(가) 연결된 Google 비즈니스 프로필 매장과 일치하지 않습니다. 판매자 센터 계정이 올바르게 연결되어 있고 Google 비즈니스 프로필에 매장이 있지만 LfpStore 위치 주소가 Google 비즈니스 프로필 매장 주소와 일치하지 않습니다. LfpStore 주소 또는 Google 비즈니스 프로필 매장 주소가 정확하게 일치하도록 업데이트하세요.
  • "store-match-unverified": 일치하는 Google 비즈니스 프로필 매장이 확인되지 않아 제공된 LfpStore을(를) 연결된 Google 비즈니스 프로필 매장과 일치시킬 수 없습니다. Google 비즈니스 프로필 인증 절차를 거쳐야 정확하게 일치시킬 수 있습니다.

StoreMatchingState

LfpStore과(와) 일치하는 Google 비즈니스 프로필의 상태입니다.

열거형
STORE_MATCHING_STATE_UNSPECIFIED 매장 일치 상태가 지정되지 않았습니다.
STORE_MATCHING_STATE_MATCHED LfpStore이(가) Google 비즈니스 프로필 매장과 일치합니다.
STORE_MATCHING_STATE_FAILED LfpStore이(가) Google 비즈니스 프로필 매장과 일치하지 않습니다.

ListLfpStoresRequest

ListLfpStores 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. LFP 파트너입니다. 형식: accounts/{account}

target_account

int64

필수 항목입니다. 매장을 나열할 판매자의 판매자 센터 ID입니다.

page_size

int32

선택사항입니다. 지정된 계정에서 반환할 LfpStore 리소스의 최대 개수입니다. 지정된 계정의 매장 수가 pageSize보다 작으면 서비스가 이 값보다 적게 반환합니다. 기본값은 250입니다. 최댓값은 1, 000입니다. 최댓값보다 높은 값을 지정하면 pageSize가 기본적으로 최댓값으로 설정됩니다.

page_token

string

선택사항입니다. 이전 ListLfpStoresRequest 호출에서 받은 페이지 토큰입니다. 다음 페이지를 검색하려면 페이지 토큰을 제공하세요. 페이지로 나눌 때 ListLfpStoresRequest에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 이전 요청에 대한 응답에서 nextPageToken로 반환된 토큰입니다.

ListLfpStoresResponse

ListLfpStores 메서드의 응답 메시지입니다.

입력란
lfp_stores[]

LfpStore

지정된 판매자의 매장입니다.

next_page_token

string

다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.