Container Versions

容器的容器版本。您可將容器版本視為容器設定在特定時間點的不可變更複本 (快照)。如果使用 create 方法建立新版本，系統會根據目前設定 (即容器的巨集、規則和代碼) 建立版本。restore 方法會使用指定版本還原容器設定。update 方法可更新版本的 name 和 notes 欄位。如要擷取目前已發布的版本，請使用 get 方法，並為 containerVersionId 指定 published。

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

資源表示法

代表 Google 代碼管理工具容器版本。

{
  "accountId": string,
  "containerId": string,
  "containerVersionId": string,
  "name": string,
  "deleted": boolean,
  "notes": string,
  "container": accounts.containers Resource,
  "macro": [
    {
      "accountId": string,
      "containerId": string,
      "macroId": string,
      "name": string,
      "type": string,
      "notes": string,
      "scheduleStartMs": long,
      "scheduleEndMs": long,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ],
      "enablingRuleId": [
        string
      ],
      "disablingRuleId": [
        string
      ],
      "fingerprint": string,
      "parentFolderId": string
    }
  ],
  "rule": [
    {
      "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
    }
  ],
  "tag": [
    accounts.containers.tags Resource
  ],
  "trigger": [
    accounts.containers.triggers Resource
  ],
  "variable": [
    accounts.containers.variables Resource
  ],
  "folder": [
    accounts.containers.folders Resource
  ],
  "fingerprint": string
}

屬性名稱	值	說明	附註
accountId	string	GTM 帳戶 ID。
container	nested object	這個版本的來源容器。
containerId	string	GTM 容器 ID。
containerVersionId	string	containerVersionId 是 GTM 容器版本的專屬識別。
deleted	boolean	如果值為 true，表示這個容器版本已刪除。
fingerprint	string	GTM 容器版本的指紋，在儲存時計算。每當您修改容器版本，系統就會重新計算這個值。
folder[]	list	容器中存放這個版本的來源資料夾。
macro[]	list	版本取自容器中的巨集。
macro[].accountId	string	GTM 帳戶 ID。
macro[].containerId	string	GTM 容器 ID。
macro[].disablingRuleId[]	list	僅適用於行動容器：列出停用條件巨集的規則 ID。如果其中一項啟用規則為 True，且所有停用規則皆為 False，系統就會啟用巨集。視為未排序的集合。
macro[].enablingRuleId[]	list	僅適用於行動容器：啟用條件巨集的規則 ID 清單；如果其中一項啟用規則為 True，且所有停用規則皆為 False，系統就會啟用巨集。視為未排序的集合。
macro[].fingerprint	string	在儲存期間計算的 GTM 巨集指紋。只要修改巨集，系統就會重新計算這個值。
macro[].macroId	string	巨集 ID 是專門用來識別 Google 代碼管理工具巨集的 ID。
macro[].name	string	巨集顯示名稱。
macro[].notes	string	關於如何在容器中套用此巨集的使用者附註。
macro[].parameter[]	list	巨集的參數。
macro[].parameter[].key	string	專門用於識別參數的具名鍵。頂層參數和對應值的必要項目。系統會忽略清單值。	可寫入
macro[].parameter[].list[]	list	這份清單參數的參數 (金鑰會忽略)。	可寫入
macro[].parameter[].map[]	list	此對應參數的參數 (必須具有鍵；索引鍵不得重複)。	可寫入
macro[].parameter[].type	string	參數類型。有效的值包括： boolean：值代表布林值，以「true」表示或「false」 integer：值代表以 10 為底的 64 位元帶正負號整數值 list：應指定參數清單 map：應指定參數對應 template：值代表任何文字；這可能包含變數參照 (包括可能會傳回非字串類型的變數參照) trigger_reference：值代表觸發條件，以觸發條件 ID 表示 ，瞭解如何調查及移除這項存取權。 可接受的值為： 「boolean」 「integer」 「list」 「map」 「template」 「triggerReference」	可寫入
macro[].parameter[].value	string	視指定類型而定，參數的值 (可包含「」等變數參照)。	可寫入
macro[].parentFolderId	string	父項資料夾 ID。
macro[].scheduleEndMs	long	排定巨集的結束時間戳記 (以毫秒為單位)。
macro[].scheduleStartMs	long	設定巨集的開始時間戳記 (以毫秒為單位)。
macro[].type	string	GTM 巨集類型。
name	string	容器版本顯示名稱。	可寫入
notes	string	如何在容器中套用這個容器版本的使用者備註。	可寫入
rule[]	list	容器中取得這個版本的來源規則。
rule[].accountId	string	GTM 帳戶 ID。
rule[].condition[]	list	包含此規則的條件清單 (隱含 AND 介於條件之間)。
rule[].condition[].parameter[]	list	已命名參數 (鍵/值) 清單，視條件類型而定。注意事項： 如果是二進位運算子，請加入名為 arg0 和 arg1 的參數，分別指定左右運算元。 目前，左運算元 (arg0) 必須是變數的參照。 為了進行與規則運算式比對時不區分大小寫，請加入名為 ignore_case 的布林參數，並設為 true。如未指定或設為任何其他值，比對作業會區分大小寫。 如要否定運算子，請加入名為 negate 的布林參數，並設為 true。	可寫入
rule[].condition[].parameter[].key	string	專門用於識別參數的具名鍵。頂層參數和對應值的必要項目。系統會忽略清單值。	可寫入
rule[].condition[].parameter[].list[]	list	這份清單參數的參數 (金鑰會忽略)。	可寫入
rule[].condition[].parameter[].map[]	list	此對應參數的參數 (必須具有鍵；索引鍵不得重複)。	可寫入
rule[].condition[].parameter[].type	string	參數類型。有效的值包括： boolean：值代表布林值，以「true」表示或「false」 integer：值代表以 10 為底的 64 位元帶正負號整數值 list：應指定參數清單 map：應指定參數對應 template：值代表任何文字；這可能包含變數參照 (包括可能會傳回非字串類型的變數參照) trigger_reference：值代表觸發條件，以觸發條件 ID 表示 ，瞭解如何調查及移除這項存取權。 可接受的值為： 「boolean」 「integer」 「list」 「map」 「template」 「triggerReference」	可寫入
rule[].condition[].parameter[].value	string	視指定類型而定，參數的值 (可包含「」等變數參照)。	可寫入
rule[].condition[].type	string	此條件的運算子類型。 可接受的值為： 「contains」 「cssSelector」 「endsWith」 「equals」 「greater」 「greaterOrEquals」 「less」 「lessOrEquals」 「matchRegex」 「startsWith」 「urlMatches」	可寫入
rule[].containerId	string	GTM 容器 ID。
rule[].fingerprint	string	在儲存期間計算出的 GTM 規則指紋。您修改規則後，系統就會重新計算這個值。
rule[].name	string	規則顯示名稱。
rule[].notes	string	有關如何在容器中套用這項規則的使用者附註。
rule[].ruleId	string	每個 GTM 規則都有專屬的規則 ID。
tag[]	list	版本取自容器中的代碼。
trigger[]	list	取得這個版本的容器中的觸發條件。
variable[]	list	版本擷取來源容器中的變數。

方法

建立

建立容器版本。

刪除

刪除容器版本。

取得

取得容器版本。

list

列出 GTM 容器的所有容器版本。

發布

發布容器版本。

還原

還原容器版本。這會覆寫容器中目前的 設定 (包括其變數、觸發條件和代碼)。作業 不影響目前提供的版本 (亦即 已發布的版本)。

取消刪除

取消刪除容器版本。

更新

更新容器版本。