REST Resource: advertisers.manualTriggers

资源:ManualTrigger

Display & 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

更新手动触发器。