Rules

容器的規則。規則在執行階段會評估為 true 或 false。這類參數可用於控制代碼的觸發或禁止啟用的時間，以及控制行動容器中巨集的啟用或停用時機。詳情請參閱代碼設定的啟動和停用規則，以及巨集設定的啟用和停用規則。

如需本資源的方法清單，請見本頁結尾。

資源表示法

代表 Google 代碼管理工具規則。

{
  "accountId": string,
  "containerId": string,
  "ruleId": string,
  "name": string,
  "notes": string,
  "condition": [
    {
      "type": string,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ]
    }
  ],
  "fingerprint": string
}
資源名稱 值 說明 附註
accountId string GTM 帳戶 ID。
condition[] list 組成這項規則的條件清單 (兩者之間隱含 AND)。 可寫入
condition[].parameter[] list 根據條件類型而定的已命名參數 (鍵/值) 清單。附註：
  • 針對二進位運算子，請加入名為 arg0 和 arg1 的參數，分別指定左右運算元。
  • 目前，左運算元 (arg0) 必須是巨集的參照。
  • 對於不區分大小寫的規則運算式比對，請加入名為 ignore_case 的布林值參數，並設為 true。如未指定或設為任何其他值，比對會區分大小寫。
  • 如要否定運算子，請加入名為 negate 的布林參數，並將其設為 true。
 可寫入
condition[].parameter[].key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
condition[].parameter[].list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
condition[].parameter[].map[] list 此對應參數的參數 (必須有鍵，鍵不得重複)。 可寫入
condition[].parameter[].type string 參數類型。有效值如下：
  • boolean：這個值代表布林值，以「true」或「false」表示
  • integer：這個值代表 64 位元的帶正負號整數值，以 10 為底數
  • list：應指定參數清單
  • map：應指定參數對應
  • template：這個值代表任何文字，可能包括巨集參照 (甚至是可能會傳回非字串類型的巨集參照)


可接受的值為：
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
 可寫入
condition[].parameter[].value string 符合指定類型的參數值 (可能包含「」等巨集參照)。 可寫入
condition[].type string 此條件的運算子類型。

可接受的值為：
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
 可寫入
containerId string GTM 容器 ID。
fingerprint string 儲存時計算出的 GTM 規則指紋。每當規則修改時，系統都會重新計算這個值。
name string 規則顯示名稱。 可寫入
notes string 使用者說明如何在容器中套用這項規則。 可寫入
ruleId string 規則 ID 可用來識別 Google 代碼管理工具規則。

方法

您可以使用以下方法建立、修改、刪除或擷取規則。

建立
建立 GTM 規則。
刪除
刪除 GTM 規則。
取得
取得 GTM 規則。
list
列出容器的所有 GTM 規則。
更新
更新 GTM 規則。