Triggers: create

建立 GTM 觸發條件。 立即試用。

要求

HTTP 要求

POST https://www.googleapis.com/tagmanager/v2/+parent/triggers

參數

參數名稱 值 說明
路徑參數
parent string GTM Workspace 的 API 相對路徑。範例：accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

授權

此要求需要取得下列範圍的授權：

範圍
https://www.googleapis.com/auth/tagmanager.edit.containers

詳情請參閱驗證和授權頁面。

要求主體

在要求內文中，提供觸發條件資源並附上以下屬性：

資源名稱 值 說明 附註
必要屬性
autoEventFilter[].parameter[] list 根據條件類型而定的已命名參數 (鍵/值) 清單。附註：
  • 針對二進位運算子，請加入名為 arg0 和 arg1 的參數，分別指定左右運算元。
  • 目前，左運算元 (arg0) 必須是變數的參照。
  • 對於不區分大小寫的規則運算式比對，請加入名為 ignore_case 的布林值參數，並設為 true。如未指定或設為任何其他值，比對會區分大小寫。
  • 如要否定運算子，請加入名為 negate 布林參數的布林值參數，並設為 true。
 可寫入
autoEventFilter[].parameter[].type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
autoEventFilter[].type string 此條件的運算子類型。

可接受的值為：
  • "conditionTypeUnspecified"
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
 可寫入
checkValidation.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
continuousTimeMinMilliseconds.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
customEventFilter[].parameter[] list 根據條件類型而定的已命名參數 (鍵/值) 清單。附註：
  • 針對二進位運算子，請加入名為 arg0 和 arg1 的參數，分別指定左右運算元。
  • 目前，左運算元 (arg0) 必須是變數的參照。
  • 對於不區分大小寫的規則運算式比對，請加入名為 ignore_case 的布林值參數，並設為 true。如未指定或設為任何其他值，比對會區分大小寫。
  • 如要否定運算子，請加入名為 negate 布林參數的布林值參數，並設為 true。
 可寫入
customEventFilter[].parameter[].type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
customEventFilter[].type string 此條件的運算子類型。

可接受的值為：
  • "conditionTypeUnspecified"
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
 可寫入
eventName.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
filter[].parameter[] list 根據條件類型而定的已命名參數 (鍵/值) 清單。附註：
  • 針對二進位運算子，請加入名為 arg0 和 arg1 的參數，分別指定左右運算元。
  • 目前，左運算元 (arg0) 必須是變數的參照。
  • 對於不區分大小寫的規則運算式比對，請加入名為 ignore_case 的布林值參數，並設為 true。如未指定或設為任何其他值，比對會區分大小寫。
  • 如要否定運算子，請加入名為 negate 布林參數的布林值參數，並設為 true。
 可寫入
filter[].parameter[].type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
filter[].type string 此條件的運算子類型。

可接受的值為：
  • "conditionTypeUnspecified"
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
 可寫入
horizontalScrollPercentageList.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
interval.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
intervalSeconds.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
limit.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
maxTimerLengthSeconds.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
name string 觸發條件顯示名稱。 可寫入
parameter[].type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
selector.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
totalTimeMinMilliseconds.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
type string 定義導致此觸發條件的資料層事件。

可接受的值為：
  • "always"
  • "ampClick"
  • "ampScroll"
  • "ampTimer"
  • "ampVisibility"
  • "click"
  • "consentInit"
  • "customEvent"
  • "domReady"
  • "elementVisibility"
  • "eventTypeUnspecified"
  • "firebaseAppException"
  • "firebaseAppUpdate"
  • "firebaseCampaign"
  • "firebaseFirstOpen"
  • "firebaseInAppPurchase"
  • "firebaseNotificationDismiss"
  • "firebaseNotificationForeground"
  • "firebaseNotificationOpen"
  • "firebaseNotificationReceive"
  • "firebaseOsUpdate"
  • "firebaseSessionStart"
  • "firebaseUserEngagement"
  • "formSubmission"
  • "historyChange"
  • "init"
  • "jsError"
  • "linkClick"
  • "pageview"
  • "scrollDepth"
  • "serverPageview"
  • "timer"
  • "triggerGroup"
  • "windowLoaded"
  • "youTubeVideo"
 可寫入
uniqueTriggerId.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
verticalScrollPercentageList.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
visibilitySelector.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
visiblePercentageMax.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
visiblePercentageMin.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
waitForTags.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
waitForTagsTimeout.type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：此值代表任何文字，可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference：這個值代表觸發條件，以觸發條件 ID 表示
  • tag_reference：這個值代表標記，以標記名稱表示


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 可寫入
選用屬性
autoEventFilter[] list 用於自動事件追蹤。 可寫入
autoEventFilter[].parameter[].key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
autoEventFilter[].parameter[].list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
autoEventFilter[].parameter[].map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
autoEventFilter[].parameter[].value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
checkValidation nested object 是否只有在其他事件處理常式 (例如驗證後) 未取消提交表單或連結點擊事件的情況下，才應觸發代碼。僅適用於「表單提交」和「連結點擊」觸發條件。 可寫入
checkValidation.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
checkValidation.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
checkValidation.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
checkValidation.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
continuousTimeMinMilliseconds nested object 瀏覽權限觸發條件的連續顯示時間下限 (以毫秒為單位)。僅適用於 AMP 瀏覽權限觸發條件。 可寫入
continuousTimeMinMilliseconds.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
continuousTimeMinMilliseconds.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
continuousTimeMinMilliseconds.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
continuousTimeMinMilliseconds.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
customEventFilter[] list 用於自訂事件，在所有條件為 True 時觸發。 可寫入
customEventFilter[].parameter[].key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
customEventFilter[].parameter[].list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
customEventFilter[].parameter[].map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
customEventFilter[].parameter[].value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
eventName nested object 所觸發 GTM 事件的名稱。僅適用於計時器觸發條件。 可寫入
eventName.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
eventName.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
eventName.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
eventName.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
filter[] list 只有在所有條件都符合時，觸發條件才會啟動。 可寫入
filter[].parameter[].key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
filter[].parameter[].list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
filter[].parameter[].map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
filter[].parameter[].value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
horizontalScrollPercentageList nested object 捲動觸發條件的整數百分比值清單。水平捲動瀏覽各百分比時，觸發條件就會啟動。僅適用於 AMP 捲動觸發條件。 可寫入
horizontalScrollPercentageList.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
horizontalScrollPercentageList.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
horizontalScrollPercentageList.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
horizontalScrollPercentageList.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
interval nested object 觸發週期性計時器事件的間隔時間 (以毫秒為單位)。僅適用於計時器觸發條件。 可寫入
interval.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
interval.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
interval.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
interval.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
intervalSeconds nested object 觸發計時器事件的間隔時間 (以秒為單位)。僅適用於 AMP 計時器觸發條件。 可寫入
intervalSeconds.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
intervalSeconds.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
intervalSeconds.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
intervalSeconds.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
limit nested object 限制這個計時器觸發條件要觸發的 GTM 事件數量。如未設定限制，我們會繼續觸發 GTM 事件，直到使用者離開網頁為止。僅適用於計時器觸發條件。 可寫入
limit.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
limit.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
limit.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
limit.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
maxTimerLengthSeconds nested object 觸發計時器事件的最長時間 (以秒為單位)。僅適用於 AMP 計時器觸發條件。 可寫入
maxTimerLengthSeconds.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
maxTimerLengthSeconds.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
maxTimerLengthSeconds.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
maxTimerLengthSeconds.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
notes string 使用者在容器中套用這個觸發條件的附註。 可寫入
parameter[] list 其他參數。 可寫入
parameter[].key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
parameter[].list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
parameter[].map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
parameter[].value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
selector nested object 點擊觸發條件 CSS 選取器 (例如「a」、「按鈕」等)。僅適用於 AMP 點擊觸發條件。 可寫入
selector.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
selector.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
selector.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
selector.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
totalTimeMinMilliseconds nested object 顯示設定觸發條件的最少可視時間總數 (以毫秒為單位)。僅適用於 AMP 瀏覽權限觸發條件。 可寫入
totalTimeMinMilliseconds.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
totalTimeMinMilliseconds.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
totalTimeMinMilliseconds.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
totalTimeMinMilliseconds.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
uniqueTriggerId nested object 自動產生此觸發條件 (「表單提交」、「連結點擊」或「計時器」事件監聽器) 的全域專屬 ID (如果有的話)。用於讓不相容的自動事件，搭配觸發條件 ID 的觸發條件篩選功能搭配使用。在產生輸出時填入這個值，因為觸發條件所隱含的代碼必須等到之後才存在。僅適用於表單提交、連結點擊和計時器觸發條件。 可寫入
uniqueTriggerId.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
uniqueTriggerId.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
uniqueTriggerId.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
uniqueTriggerId.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
verticalScrollPercentageList nested object 捲動觸發條件的整數百分比值清單。以垂直捲動方式捲動瀏覽皆達到每個百分比時，觸發條件就會啟動。僅適用於 AMP 捲動觸發條件。 可寫入
verticalScrollPercentageList.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
verticalScrollPercentageList.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
verticalScrollPercentageList.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
verticalScrollPercentageList.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
visibilitySelector nested object 瀏覽權限觸發條件 CSS 選取器 (例如「#id」)。僅適用於 AMP 瀏覽權限觸發條件。 可寫入
visibilitySelector.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
visibilitySelector.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
visibilitySelector.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
visibilitySelector.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
visiblePercentageMax nested object 瀏覽權限觸發條件百分比設定上限。僅適用於 AMP 瀏覽權限觸發條件。 可寫入
visiblePercentageMax.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
visiblePercentageMax.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
visiblePercentageMax.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
visiblePercentageMax.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
visiblePercentageMin nested object 可見度觸發條件的最低顯示設定百分比。僅適用於 AMP 瀏覽權限觸發條件。 可寫入
visiblePercentageMin.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
visiblePercentageMin.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
visiblePercentageMin.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
visiblePercentageMin.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
waitForTags nested object 是否應將提交表單或連結開啟時間延後到所有代碼都觸發為止 (避免預設動作，之後再模擬預設動作)。僅適用於「表單提交」和「連結點擊」觸發條件。 可寫入
waitForTags.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
waitForTags.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
waitForTags.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
waitForTags.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
waitForTagsTimeout nested object 當上述「waits_for_tags」評估為 true 時，代碼要觸發的時間長度 (以毫秒為單位)。僅適用於「表單提交」和「連結點擊」觸發條件。 可寫入
waitForTagsTimeout.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
waitForTagsTimeout.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
waitForTagsTimeout.map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
waitForTagsTimeout.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入

回應

如果成功，這個方法會在回應主體中傳回觸發條件資源。

試試看！

您可以使用下方的 APIs Explorer，針對即時資料呼叫這個方法，然後查看回應。