REST Resource: products

资源：Product

单个商品。

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)

必需。预订产品所需的提前期。现在 + bookingLeadTime 应晚于排期开始。

该持续时间以秒为单位，最多包含九个小数位，以“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 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

仅限输出。商品的上次更新时间时间戳。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
currencyCode

string

ISO 4217 中定义的由 3 个字母组成的大写货币代码。

方法

create

 创建新产品。

get

 检索单个商品。

list

 列出商品。

patch

 更新现有商品。