Package google.shopping.merchant.inventories.v1beta

색인

LocalInventoryService

제품의 오프라인 판매점 인벤토리를 관리하는 서비스

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

지정된 LocalInventory를 판매자 계정의 지정된 제품에서 삭제합니다. LocalInventory가 특정 제품에서 삭제되는 데 최대 1시간이 걸릴 수 있습니다. 삭제에 성공했다는 응답을 받으면 해당 기간 동안 기다린 후에 삭제를 다시 시도하세요.

승인 범위

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

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

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

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

판매자 계정의 제품에 LocalInventory 리소스를 삽입합니다.

제품에 동일한 storeCode가 있는 항목이 이미 있는 경우 전체 LocalInventory 리소스를 바꿉니다.

신규 또는 업데이트된 LocalInventory 리소스가 제품에 표시되는 데 최대 30분이 걸릴 수 있습니다.

승인 범위

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

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

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

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

판매자 계정에서 지정된 제품에 대한 LocalInventory 리소스를 나열합니다. 응답에 pageSize에서 지정한 것보다 적은 항목이 포함될 수 있습니다. 이전 요청에서 pageToken가 반환되었다면 추가 결과를 가져오는 데 사용할 수 있습니다.

지정된 계정의 제품별로 리소스 LocalInventory개가 표시됩니다.

승인 범위

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

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

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

RegionalInventoryService

제품의 지역 인벤토리를 관리하는 서비스입니다. 리전 정의를 관리하는 별도의 regions 리소스와 API도 있습니다.

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

판매자 계정의 지정된 제품에서 지정된 RegionalInventory 리소스를 삭제합니다. RegionalInventory가 특정 제품에서 삭제되는 데 최대 1시간이 걸릴 수 있습니다. 삭제에 성공했다는 응답을 받으면 해당 기간 동안 기다린 후에 삭제를 다시 시도하세요.

승인 범위

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

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

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

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

판매자 계정의 특정 제품에 RegionalInventory를 삽입합니다.

제품에 동일한 region가 있는 항목이 이미 있는 경우 전체 RegionalInventory 리소스를 바꿉니다.

신규 또는 업데이트된 RegionalInventory 리소스가 제품에 표시되는 데 최대 30분이 걸릴 수 있습니다.

승인 범위

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

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

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

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

판매자 계정에서 지정된 제품에 대한 RegionalInventory 리소스를 나열합니다. 응답에 pageSize에서 지정한 것보다 적은 항목이 포함될 수 있습니다. 이전 요청에서 pageToken가 반환되었다면 추가 결과를 가져오는 데 사용할 수 있습니다.

지정된 계정의 제품별로 리소스 RegionalInventory개가 표시됩니다.

승인 범위

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

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

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

DeleteLocalInventoryRequest

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

입력란
name

string

필수 항목입니다. 특정 제품의 삭제할 오프라인 판매점 인벤토리 이름입니다. 형식: accounts/{account}/products/{product}/localInventories/{store_code}

DeleteRegionalInventoryRequest

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

입력란
name

string

필수 항목입니다. 삭제할 RegionalInventory 리소스의 이름입니다. 형식: accounts/{account}/products/{product}/regionalInventories/{region}

InsertLocalInventoryRequest

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

입력란
parent

string

필수 항목입니다. 이 인벤토리가 삽입될 계정과 제품입니다. 형식: accounts/{account}/products/{product}
local_inventory

LocalInventory

필수 항목입니다. 제품의 오프라인 판매점 인벤토리 정보입니다. 제품에 동일한 storeCode에 대한 LocalInventory 리소스가 이미 있는 경우 LocalInventory 리소스가 완전히 대체됩니다.

InsertRegionalInventoryRequest

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

입력란
parent

string

필수 항목입니다. 이 인벤토리가 삽입될 계정과 제품입니다. 형식: accounts/{account}/products/{product}
regional_inventory

RegionalInventory

필수 항목입니다. 제품에 추가할 지역 인벤토리 정보입니다. 제품에 동일한 region에 대한 RegionalInventory 리소스가 이미 있는 경우 RegionalInventory 리소스가 완전히 대체됩니다.

ListLocalInventoriesRequest

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

입력란
parent

string

필수 항목입니다. 오프라인 판매점 인벤토리를 나열할 상위 제품의 name입니다. 형식: accounts/{account}/products/{product}
page_size

int32

특정 제품이 반환할 LocalInventory 리소스의 최대 개수입니다. 지정된 제품의 인벤토리 수가 pageSize보다 적으면 서비스에서 이 값보다 적은 수를 반환합니다. 기본값은 25,000입니다. 최댓값은 25, 000입니다. 최댓값보다 큰 값을 지정하면 pageSize이 기본적으로 최댓값으로 설정됩니다.
page_token

string

이전 ListLocalInventories 호출에서 받은 페이지 토큰입니다. 다음 페이지를 검색하려면 페이지 토큰을 제공하세요.

페이지를 매길 때 ListLocalInventories에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 이전 요청에 대한 응답에서 nextPageToken로 반환된 토큰입니다.

ListLocalInventoriesResponse

ListLocalInventories 메서드에 대한 응답 메시지입니다.

입력란
local_inventories[]

LocalInventory

지정된 계정에서 지정된 제품에 대한 LocalInventory 리소스입니다.
next_page_token

string

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

ListRegionalInventoriesRequest

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

입력란
parent

string

필수 항목입니다. RegionalInventory 리소스를 나열할 상위 제품의 name입니다. 형식: accounts/{account}/products/{product}
page_size

int32

특정 제품이 반환할 RegionalInventory 리소스의 최대 개수입니다. 지정된 제품의 인벤토리 수가 pageSize보다 적으면 서비스에서 이 값보다 적은 수를 반환합니다. 기본값은 25,000입니다. 최댓값은 100, 000입니다. 최댓값보다 큰 값을 지정하면 pageSize가 기본적으로 최댓값으로 설정됩니다.
page_token

string

이전 ListRegionalInventories 호출에서 받은 페이지 토큰입니다. 다음 페이지를 검색하려면 페이지 토큰을 제공하세요.

페이지를 매길 때 ListRegionalInventories에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 이전 요청에 대한 응답에서 nextPageToken로 반환된 토큰입니다.

ListRegionalInventoriesResponse

ListRegionalInventories 메서드에 대한 응답 메시지입니다.

입력란
regional_inventories[]

RegionalInventory

지정된 계정에서 지정된 제품에 대한 RegionalInventory 리소스입니다.
next_page_token

string

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

LocalInventory

제품의 오프라인 판매점 인벤토리 정보입니다. storeCode로 지정한 매장의 특정 제품에 대한 매장 정보를 나타냅니다. 허용되는 모든 속성 값의 목록은 오프라인 제품 인벤토리 데이터 사양을 참조하세요.

입력란
name

string

출력 전용입니다. LocalInventory 리소스 이름입니다. 형식: accounts/{account}/products/{product}/localInventories/{store_code}
account

int64

출력 전용입니다. 제품을 소유한 계정입니다. 이 필드는 클라이언트에 의해 설정된 경우 무시됩니다.
store_code

string

필수 항목입니다. 변경할 수 없습니다. 제품을 판매하는 오프라인 상점의 판매점 코드 (비즈니스 프로필의 판매점 ID) 자세한 내용은 오프라인 제품 인벤토리 데이터 사양을 참조하세요.
price

Price

이 매장의 제품 가격입니다.
sale_price

Price

이 상점의 제품 할인가입니다. salePriceEffectiveDate가 정의된 경우 필수입니다.
sale_price_effective_date

Interval

이 매장에서의 판매 TimePeriod입니다.
custom_attributes[]

CustomAttribute

판매자 제공 커스텀 속성 목록입니다. CustomAttribute를 사용하여 데이터 사양의 속성을 일반 형식으로 제출할 수도 있습니다.
availability

string

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

int64

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

string

이 제품에서 지원되는 수령 방법입니다. 값이 "not supported"가 아니면 이 입력란을 pickupSla와 함께 제출해야 합니다. 허용되는 속성 값은 오프라인 제품 인벤토리 데이터 사양을 참조하세요.
pickup_sla

string

이 매장의 이 제품 주문 날짜로부터 수령 준비 완료까지의 상대적 기간입니다. pickupMethod와 함께 제출해야 합니다. 허용되는 속성 값은 오프라인 제품 인벤토리 데이터 사양을 참조하세요.
instore_product_location

string

매장 내 제품 위치입니다. 최대 길이는 20바이트입니다.

RegionalInventory

제품의 지역 인벤토리 정보입니다. 특정 region에서 지정된 제품의 가격 및 재고와 같은 구체적인 정보를 나타냅니다. 허용되는 모든 속성 값의 목록은 지역별 제품 인벤토리 데이터 사양을 참조하세요.

입력란
name

string

출력 전용입니다. RegionalInventory 리소스 이름입니다. 형식: {regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}
account

int64

출력 전용입니다. 제품을 소유한 계정입니다. 이 필드는 클라이언트에 의해 설정된 경우 무시됩니다.
region

string

필수 항목입니다. 변경할 수 없습니다. 이 RegionalInventory 리소스의 리전 ID입니다. 자세한 내용은 지역별 재고 및 가격을 참조하세요.
price

Price

이 지역의 제품 가격입니다.
sale_price

Price

이 지역에서 판매되는 제품의 할인가입니다. salePriceEffectiveDate가 정의된 경우 필수입니다.
sale_price_effective_date

Interval

이 지역 할인가의 TimePeriod입니다.
custom_attributes[]

CustomAttribute

판매자 제공 커스텀 속성 목록입니다. CustomAttribute를 사용하여 데이터 사양의 속성을 일반 형식으로 제출할 수도 있습니다.
availability

string

이 지역에서의 제품 재고입니다. 허용되는 속성 값은 지역별 제품 인벤토리 데이터 사양을 참조하세요.