REST Resource: products

資源：產品

單一產品。

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

string

產品的資源名稱，格式如下：products/{id}。例如 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)

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

string (Duration format)

必要欄位。預訂產品所需的前置時間。現在，bookLeadTime 應該在航班開始後。

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

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"。
currencyCode

string

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

方法

create

 建立新產品。

get

 擷取個別產品。

list

 列出產品。

patch

 更新現有產品。