REST Resource: projects.locations.products

資源：產品

產品包含 ReferenceImages。

JSON 表示法 
{
  "name": string,
  "displayName": string,
  "description": string,
  "productCategory": string,
  "productLabels": [
    {
      object (KeyValue)
    }
  ]
}
欄位
name

string

產品的資源名稱。

格式為：projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID。

建立產品時，系統會忽略這個欄位。
displayName

string

使用者提供的產品名稱。不得留空。長度不得超過 4096 個半形字元。

description

string

使用者提供的要儲存在本產品中的中繼資料。長度不得超過 4096 個半形字元。

productCategory

string

不可變動。參考圖像所識別的產品類別。這個值應為「homegoods-v2」、「apparel-v2」或「toys-v2」。系統仍支援舊版類別「家居用品」、「服飾」和「玩具」，但不應用於新產品。

productLabels[]

object (KeyValue)

這是可以附加至產品的鍵/值組合，在查詢時，您可以根據 productLabels 指定限制。

請注意，整數值可以字串形式提供，例如「1199」。只有含有整數值的字串才能符合範圍限制 (這項限制即將支援)。

同一個鍵可以指派多個值。一項產品最多可有 500 個 productLabels。

請注意，一個 ProductSet 中所有產品的 distinct productLabels 總數不得超過 100 萬，否則產品搜尋管道將拒絕為該 ProductSet 運作。

KeyValue

以鍵/值組合表示的產品標籤。

JSON 表示法 
{
  "key": string,
  "value": string
}
欄位
key

string

產品附帶標籤的鍵。不得為空白，且大小不得超過 128 個位元組。

value

string

產品附帶標籤的值。不得為空白，且大小不得超過 128 個位元組。

方法

create

 建立並傳回新產品資源。

delete

 永久刪除產品及其參考圖片。

get

 取得與產品相關聯的資訊。

list

 以未指定的順序列出產品。

patch

 變更 Product 資源。

purge

 非同步 API，用於刪除 ProductSet 中的所有產品，或不屬於任何 ProductSet 的所有產品。