REST Resource: advertisers.manualTriggers

资源:ManualTrigger

展示广告和Video 360。

警告:使用手动触发器的订单项不再在 Display & Video 360 中投放。本资源将于 2023 年 8 月 1 日停用。如需了解详情,请参阅我们的功能弃用公告

JSON 表示法
{
  "name": string,
  "advertiserId": string,
  "triggerId": string,
  "displayName": string,
  "activationDurationMinutes": string,
  "latestActivationTime": string,
  "state": enum (State)
}
字段
name

string

仅限输出。人工触发器的资源名称。

advertiserId

string (int64 format)

必需。不可变。手动触发器所属广告客户的唯一 ID。

triggerId

string (int64 format)

仅限输出。手动触发器的唯一 ID。

displayName

string

必需。人工触发器的显示名称。

必须采用 UTF-8 编码,大小不超过 240 个字节。

activationDurationMinutes

string (int64 format)

必需。每次启用的最长时长(以分钟为单位)。必须介于 1 到 360 之间(含 1 和 360)。在此时长后,触发器将自动停用。

latestActivationTime

string (Timestamp format)

仅限输出。触发器上次激活的时间戳。

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

state

enum (State)

仅限输出。手动触发器的状态。将在创建时设为 INACTIVE 状态。

手动触发器的状态。

枚举
STATE_UNSPECIFIED 在此版本中,如果未指定状态或状态未知,则默认值为此值。
INACTIVE 触发器目前处于未启用状态,可以启用。
ACTIVE 触发器当前处于有效状态(已启用)。

方法

activate

启用手动触发器。

create

创建新的手动触发器。

deactivate

停用手动触发器。

get

获取手动触发器。

list

列出当前用户对给定广告客户 ID 有权访问的手动触发器。

patch

更新手动触发器。