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 bất biến (ả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à 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 phiên bản được chỉ định. Phương thức update cho phép cập nhật các trường namenotes của một 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.

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

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ị 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 Trình quản lý thẻ của Google (GTM).
deleted boolean Giá trị true cho biết rằng 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 tại thời điểm lưu trữ. Giá trị này được tính toán lại mỗi khi phiên bản vùng chứa được sửa đổi.
folder[] list Các thư mục trong vùng chứa nơi phiên bản này được lấy từ đó.
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 mã 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à true trong khi tất cả các quy tắc vô hiệu hoá là false. Được coi là một tập hợp không theo thứ tự.
macro[].enablingRuleId[] list Chỉ đối với vùng chứa trên thiết bị di động: Danh sách mã 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à true trong khi tất cả các quy tắc vô hiệu hoá là false. Đượ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 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 mỗi khi macro được sửa đổi.
macro[].macroId string Mã 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 giúp nhận dạng duy nhất một thông số. Bắt buộc đối với các thông số cấp cao nhất, cũng như các giá trị bản đồ. Bỏ qua đối với các 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 Các thông số của thông số ánh xạ này (phải có khoá; khoá phải là duy nhất). có thể ghi
macro[].parameter[].type string Loại thông 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ị đại diện cho giá trị số nguyên 64 bit đã ký, trong cơ số 10
  • list: Bạn cần chỉ định danh sách các tham số
  • map: Cần chỉ định sơ đồ liên kết các tham số
  • template: Giá trị đại diện cho văn bản bất kỳ; điều 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 biến tham chiếu như "") phù hợp với loại đã 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 cho macro.
macro[].scheduleStartMs long Dấu thời gian bắt đầu tính bằng mili giây để lên lịch cho macro.
macro[].type string Loại macro GTM.
name string Tên hiển thị của 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 phiên bản này được lấ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 chúng).
rule[].condition[].parameter[] list Danh sách các 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 các toán tử nhị phân, hãy thêm các tham số có tên arg0arg1 để chỉ định toán hạng bên trái và bên phải tương ứng.
  • Tại thời điểm này, toán hạng bên trái (arg0) phải là tham chiếu đến một biến.
  • Để so khớp Biểu thức chính quy không phân biệt chữ hoa chữ thường, hãy thêm tham số boolean có tên ignore_case đượ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 được đặt thành true.
có thể ghi
rule[].condition[].parameter[].key string Khoá được đặt tên giúp nhận dạng duy nhất một thông số. Bắt buộc đối với các thông số cấp cao nhất, cũng như các giá trị bản đồ. Bỏ qua đối với các 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 Các thông số của thông số ánh xạ này (phải có khoá; khoá phải là duy nhất). có thể ghi
rule[].condition[].parameter[].type string Loại thông 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ị đại diện cho giá trị số nguyên 64 bit đã ký, trong cơ số 10
  • list: Bạn cần chỉ định danh sách các tham số
  • map: Cần chỉ định sơ đồ liên kết các tham số
  • template: Giá trị đại diện cho văn bản bất kỳ; điều 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 biến tham chiếu như "") phù hợp với loại đã 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 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 Tệp tham chiếu của Quy tắc GTM như được tính tại thời điểm lưu trữ. Giá trị này được tính toán lại mỗi khi quy tắc được sửa đổi.
rule[].name string Tên hiển thị quy tắc.
rule[].notes string Người dùng ghi chú 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 mà phiên bản này được lấy từ đó.
trigger[] list Các điều kiện kích hoạt trong vùng chứa nơi phiên bản này được lấy từ đó.
variable[] list Các biến trong vùng chứa nơi phiên bản này được lấ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ả phiên bản vùng chứa của vùng chứa Trình quản lý thẻ của Google (GTM).
xuất bản
Xuất bản một 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 đè phiên bản hiện tại của vùng chứa cấu hình (bao gồm các biến, trình kích hoạt và thẻ của nó). Toán tử sẽ không có bất kỳ ảnh hưởng nào đến phiên bản đang được phân phối (ví dụ: phiên bản đã xuất bản).
huỷ xoá
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.