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 (含) 之間。這段時間過後,系統就會自動停用觸發條件。

latestActivationTime

string (Timestamp format)

僅供輸出。最近一次啟用觸發條件的時間戳記。

RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例:"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

更新手動觸發條件。