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 name
và notes
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à:
Các giá trị được chấp nhận là:
|
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 ý:
|
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à:
Các giá trị được chấp nhận là:
|
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à:
|
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.