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 Overview를 참고하세요.
InsertLocalInventory

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

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

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

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

승인 범위

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

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

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

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

판매자 계정에서 지정된 제품의 LocalInventory 리소스를 나열합니다. 응답에 pageSize에 지정된 것보다 적은 항목이 포함될 수 있습니다. 이전 요청에서 pageToken이 반환된 경우 이를 사용하여 추가 결과를 가져올 수 있습니다.

LocalInventory 리소스는 지정된 계정의 제품별로 나열됩니다.

승인 범위

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

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

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

RegionalInventoryService

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

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

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

승인 범위

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

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

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

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

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

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

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

승인 범위

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

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

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

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

판매자 계정에서 지정된 제품의 RegionalInventory 리소스를 나열합니다. 응답에 pageSize에 지정된 것보다 적은 항목이 포함될 수 있습니다. 이전 요청에서 pageToken이 반환된 경우 이를 사용하여 추가 결과를 가져올 수 있습니다.

RegionalInventory 리소스는 지정된 계정의 제품별로 나열됩니다.

승인 범위

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

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

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

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

이 지역에서 제품을 사용할 수 있는지 여부입니다. 허용되는 속성 값은 지역 제품 인벤토리 데이터 사양을 참고하세요.