REST Resource: advertisers.manualTriggers

资源:ManualTrigger

展示广告和Video 360。

警告:使用手动触发器的订单项不再在展示广告网络中投放,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

更新手动触发器。