REST Resource: sellers.products

資源：產品

單一產品。

JSON 表示法 
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "creativeSpecifications": [
    {
      object (CreativeSpecification)
    }
  ],
  "bookingLeadDuration": string,
  "assignmentLeadDuration": string,
  "minFlightDuration": string,
  "maxFlightDuration": string,
  "slotDuration": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "currencyCode": string
}
欄位
name

string

產品的資源名稱，格式如下：sellers/{seller}/products/{product}。例如 sellers/seller111/products/product123。
externalId

string

用於將這個實體對應至外部來源的 ID。
displayName

string

必要欄位。產品的顯示名稱。

必須是 UTF-8 編碼，且長度上限為 240 個位元組。
description

string

用於描述產品的其他任意形式欄位。
labels

map (key: string, value: string)

用來描述這項產品的任意形式標籤組合。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
creativeSpecifications[]

object (CreativeSpecification)

必要欄位。可為這項產品放送的許可廣告素材清單。
bookingLeadDuration

string (Duration format)

必要欄位。預訂產品所需的待開發客戶持續時間。現在，bookLeadDuration 應該晚於檔期開始。

期間以秒為單位，小數部分最多九位數，以「s」結尾。範例："3.5s"。
assignmentLeadDuration

string (Duration format)

必要欄位。指派廣告素材所需的待開發客戶時間長度。

期間以秒為單位，小數部分最多九位數，以「s」結尾。範例："3.5s"。
minFlightDuration

string (Duration format)

這項產品的最短飛行時間。

期間以秒為單位，小數部分最多九位數，以「s」結尾。範例："3.5s"。
maxFlightDuration

string (Duration format)

必要欄位。這項產品的最高檔期。

期間以秒為單位，小數部分最多九位數，以「s」結尾。範例："3.5s"。
slotDuration

string (Duration format)

必要欄位。這項產品的運算單元時間長度。

期間以秒為單位，小數部分最多九位數，以「s」結尾。範例："3.5s"。
createTime

string (Timestamp format)

僅供輸出。產品的建立時間戳記。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

僅供輸出。產品上次更新的時間戳記。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
state

enum (State)

僅供輸出。這項產品的狀態。
currencyCode

string

必要欄位。ISO 4217 所定義的 3 個大寫字母貨幣代碼。

州

產品狀態的可能值。

列舉
STATE_UNSPECIFIED 未指定產品狀態，或這個版本中不明時的預設值。
STATE_ACTIVE 正在使用產品。
STATE_DELETED 已刪除產品。

方法

create

 建立新產品。

delete

 刪除現有產品。

get

 擷取個別產品。

list

 列出產品。

patch

 更新現有產品。