Container Versions

Phiên bản vùng chứa của một vùng chứa. Phiên bản vùng chứa có thể được coi là bản sao không thể thay đổi (ảnh chụp nhanh) của cấu hình vùng chứa tại một thời điểm cụ thể. Việc tạo phiên bản mới bằng phương thức create sẽ tạo một phiên bản dựa trên cấu hình hiện tại (tức là các macro, quy tắc và thẻ của vùng chứa). Phương thức restore sẽ khôi phục cấu hình của vùng chứa bằng cách sử dụng phiên bản đã chỉ định. Phương thức update cho phép cập nhật các trường namenotes của phiên bản. Để tìm nạp phiên bản đã phát hành, hãy sử dụng phương thức get và chỉ định published cho containerVersionId.

Để xem danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang này.

Biểu diễn tài nguyên

Đại diện cho phiên bản vùng chứa Trình quản lý thẻ của 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
}
Tên tài sản Giá trị Nội dung mô tả Ghi chú
accountId string Mã tài khoản GTM.
container nested object Vùng chứa mà phiên bản này được lấy từ đó.
containerId string Mã vùng chứa Trình quản lý thẻ của Google (GTM).
containerVersionId string containerVersionId xác định duy nhất Phiên bản vùng chứa GTM.
deleted boolean Giá trị true cho biết phiên bản vùng chứa này đã bị xoá.
fingerprint string Tệp tham chiếu của phiên bản vùng chứa GTM như được tính toán tại thời điểm lưu trữ. Giá trị này được tính toán lại bất cứ khi nào phiên bản vùng chứa được sửa đổi.
folder[] list Các thư mục trong vùng chứa lấy phiên bản này.
macro[] list Các macro trong vùng chứa mà phiên bản này được lấy từ đó.
macro[].accountId string Mã tài khoản GTM.
macro[].containerId string Mã vùng chứa Trình quản lý thẻ của Google (GTM).
macro[].disablingRuleId[] list Chỉ đối với vùng chứa trên thiết bị di động: Danh sách ID quy tắc để tắt macro có điều kiện; macro được bật nếu một trong các quy tắc bật là đúng trong khi tất cả các quy tắc vô hiệu hóa là sai. Được coi là một tập hợp không theo thứ tự.
macro[].enablingRuleId[] list Chỉ dành cho vùng chứa di động: Danh sách ID quy tắc để bật macro có điều kiện; macro được bật nếu một trong các quy tắc bật là đúng trong khi tất cả các quy tắc vô hiệu hóa là sai. Được coi là một tập hợp không theo thứ tự.
macro[].fingerprint string Vân tay số của Macro GTM được tính toán tại thời điểm lưu trữ. Giá trị này được tính toán lại bất cứ khi nào macro được sửa đổi.
macro[].macroId string ID Macro xác định duy nhất Macro GTM.
macro[].name string Tên hiển thị macro.
macro[].notes string Ghi chú của người dùng về cách áp dụng macro này trong vùng chứa.
macro[].parameter[] list Tham số của macro.
macro[].parameter[].key string Khoá được đặt tên xác định duy nhất một tham số. Bắt buộc đối với các thông số cấp cao nhất, cũng như giá trị bản đồ. Bỏ qua đối với giá trị danh sách. có thể ghi
macro[].parameter[].list[] list Các tham số của tham số danh sách này (các khoá sẽ bị bỏ qua). có thể ghi
macro[].parameter[].map[] list Tham số của thông số bản đồ này (phải có khoá; các khoá phải là duy nhất). có thể ghi
macro[].parameter[].type string Loại tham số. Các giá trị hợp lệ là:
  • boolean: Giá trị đại diện cho một boolean, được biểu thị dưới dạng "true" hoặc "false"
  • integer: Giá trị này biểu thị giá trị số nguyên 64 bit đã ký, ở cơ số 10
  • list: Danh sách các thông số phải được chỉ định
  • map: Bản đồ các tham số phải được chỉ định
  • template: Giá trị đại diện cho văn bản bất kỳ; giá trị này có thể bao gồm các tham chiếu biến (thậm chí cả các tham chiếu biến có thể trả về các loại không phải chuỗi)
  • trigger_reference: Giá trị đại diện cho một điều kiện kích hoạt, được biểu thị dưới dạng mã điều kiện kích hoạt


Các giá trị được chấp nhận là:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
có thể ghi
macro[].parameter[].value string Giá trị của thông số (có thể chứa các tham chiếu biến như "") phù hợp với loại được chỉ định. có thể ghi
macro[].parentFolderId string Mã thư mục mẹ.
macro[].scheduleEndMs long Dấu thời gian kết thúc tính bằng mili giây để lên lịch macro.
macro[].scheduleStartMs long Dấu thời gian bắt đầu tính bằng mili giây để lên lịch macro.
macro[].type string Loại macro của Trình quản lý thẻ của Google (GTM).
name string Tên hiển thị phiên bản vùng chứa. có thể ghi
notes string Ghi chú của người dùng về cách áp dụng phiên bản vùng chứa này trong vùng chứa. có thể ghi
rule[] list Các quy tắc trong vùng chứa nơi lấy phiên bản này.
rule[].accountId string Mã tài khoản GTM.
rule[].condition[] list Danh sách các điều kiện tạo nên quy tắc này (ngầm ẩn AND giữa các điều kiện).
rule[].condition[].parameter[] list Danh sách thông số được đặt tên (khoá/giá trị), tuỳ thuộc vào loại điều kiện. Lưu ý:
  • Đối với toán tử nhị phân, hãy thêm các tham số có tên arg0arg1 để chỉ định toán hạng trái và phải tương ứng.
  • Lúc này, toán hạng bên trái (arg0) phải tham chiếu đến một biến.
  • Để khớp Regex không phân biệt chữ hoa chữ thường, hãy bao gồm một tham số boolean có tên ignore_case và được đặt thành true. Nếu không được chỉ định hoặc đặt thành bất kỳ giá trị nào khác, thì kết quả khớp sẽ phân biệt chữ hoa chữ thường.
  • Để phủ định một toán tử, hãy thêm một tham số boolean có tên là tham số boolean negate và được đặt thành true.
có thể ghi
rule[].condition[].parameter[].key string Khoá được đặt tên xác định duy nhất một tham số. Bắt buộc đối với các thông số cấp cao nhất, cũng như giá trị bản đồ. Bỏ qua đối với giá trị danh sách. có thể ghi
rule[].condition[].parameter[].list[] list Các tham số của tham số danh sách này (các khoá sẽ bị bỏ qua). có thể ghi
rule[].condition[].parameter[].map[] list Tham số của thông số bản đồ này (phải có khoá; các khoá phải là duy nhất). có thể ghi
rule[].condition[].parameter[].type string Loại tham số. Các giá trị hợp lệ là:
  • boolean: Giá trị đại diện cho một boolean, được biểu thị dưới dạng "true" hoặc "false"
  • integer: Giá trị này biểu thị giá trị số nguyên 64 bit đã ký, ở cơ số 10
  • list: Danh sách các thông số phải được chỉ định
  • map: Bản đồ các tham số phải được chỉ định
  • template: Giá trị đại diện cho văn bản bất kỳ; giá trị này có thể bao gồm các tham chiếu biến (thậm chí cả các tham chiếu biến có thể trả về các loại không phải chuỗi)
  • trigger_reference: Giá trị đại diện cho một điều kiện kích hoạt, được biểu thị dưới dạng mã điều kiện kích hoạt


Các giá trị được chấp nhận là:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
có thể ghi
rule[].condition[].parameter[].value string Giá trị của thông số (có thể chứa các tham chiếu biến như "") phù hợp với loại được chỉ định. có thể ghi
rule[].condition[].type string Loại toán tử cho điều kiện này.

Các giá trị có thể chấp nhận là:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
có thể ghi
rule[].containerId string Mã vùng chứa Trình quản lý thẻ của Google (GTM).
rule[].fingerprint string Vân tay số của Quy tắc GTM như được tính toán tại thời điểm lưu trữ. Giá trị này được tính toán lại bất cứ khi nào quy tắc được sửa đổi.
rule[].name string Tên hiển thị của quy tắc.
rule[].notes string Ghi chú của người dùng về cách áp dụng quy tắc này trong vùng chứa.
rule[].ruleId string Mã quy tắc xác định duy nhất Quy tắc GTM.
tag[] list Các thẻ trong vùng chứa lấy phiên bản này.
trigger[] list Điều kiện kích hoạt trong vùng chứa lấy phiên bản này.
variable[] list Các biến trong vùng chứa lấy phiên bản này.

Phương thức

tạo
Tạo phiên bản vùng chứa.
xóa
Xoá phiên bản vùng chứa.
nhận
Nhận phiên bản vùng chứa.
list
Liệt kê tất cả các phiên bản vùng chứa của vùng chứa Trình quản lý thẻ của Google (GTM).
publish
Phát hành phiên bản vùng chứa.
khôi phục
Khôi phục phiên bản vùng chứa. Thao tác này sẽ ghi đè cấu hình hiện tại của vùng chứa (bao gồm các biến, trình kích hoạt và thẻ của vùng chứa). Thao tác này sẽ không có ảnh hưởng nào đến phiên bản đang được phân phát (tức là phiên bản đã xuất bản).
undelete
Khôi phục phiên bản vùng chứa.
cập nhật
Cập nhật phiên bản vùng chứa.