Package google.shopping.merchant.inventories.v1beta

索引

LocalInventoryService

管理店面商品目錄資料的服務

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

從商家帳戶中的指定產品刪除指定的 LocalInventory。系統最多可能需要 1 小時才能將「LocalInventory」從特定產品中刪除。收到成功刪除回應後，請等待這段時間過後，再重新嘗試刪除。

授權範圍

需要下列 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 資源。系統最多可能需要 1 小時才能將「RegionalInventory」從特定產品中刪除。收到成功刪除回應後，請等待這段時間過後，再重新嘗試刪除。

授權範圍

需要下列 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，服務會傳回小於這個值。預設值為 25000。最大值是 25000；如果指定高於上限的值，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，服務會傳回小於這個值。預設值為 25000。最大值是 100000；如果指定高於上限的值，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

此商店的產品數量。必須大於或等於零。
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

產品在這個區域的供應情形。如要瞭解系統接受的屬性值，請參閱區域商品目錄資料規格