גרסאות כלי הקיבול של כלי קיבול. ניתן לחשוב על גרסת מאגר כעותק (snapshot) של תצורת מאגר, שלא ניתן לשינוי, בנקודת זמן מסוימת. יצירת גרסה חדשה באמצעות השיטה create
תיצור גרסה המבוססת על התצורה הנוכחית (כלומר, באמצעות המאקרו, הכללים והתגים של הכלי המכיל). השיטה restore
תשחזר את תצורת הקונטיינר באמצעות הגרסה שצוינה. השיטה update
מאפשרת לעדכן את השדות name
ו-notes
של גרסה. כדי לאחזר את הגרסה הנוכחית שפורסמה, יש להשתמש בשיטה get
ולציין את הערך published
בתור containerVersionId
.
רשימה של שיטות למשאב הזה מופיעה בסוף הדף.
ייצוגים של משאבים
מייצג גרסה של מאגר תגים של Google Tag Manager.
{ "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 }
שם הנכס | Value | התיאור | הערות |
---|---|---|---|
accountId |
string |
מספר חשבון GTM. | |
container |
nested object |
הקונטיינר שממנו נלקחה הגרסה הזו. | |
containerId |
string |
מזהה מאגר תגים של GTM. | |
containerVersionId |
string |
התג containerVersionId מזהה באופן ייחודי את גרסת מאגר התגים של GTM. |
|
deleted |
boolean |
ערך של true מציין שגרסת כלי קיבול זו נמחקה. | |
fingerprint |
string |
טביעת האצבע של גרסת מאגר התגים של GTM, כפי שמחושבת בזמן האחסון. הערך הזה מחושב מחדש בכל פעם שגרסת המאגר משתנה. | |
folder[] |
list |
התיקיות במאגר שממנו נלקחה הגרסה הזו. | |
macro[] |
list |
פקודות המאקרו במאגר התגים שממנו נלקחה הגרסה הזו. | |
macro[].accountId |
string |
מספר חשבון GTM. | |
macro[].containerId |
string |
מזהה מאגר תגים של GTM. | |
macro[].disablingRuleId[] |
list |
עבור כלים מכילים של מכשירים ניידים בלבד: רשימה של מזהי כללים להשבתת פקודות מאקרו מותנות; המאקרו מופעל אם אחד מכללי ההפעלה מתקיים וכל כללי ההשבתה אינם נכונים. מטופל כקבוצה לא ממוינת. | |
macro[].enablingRuleId[] |
list |
עבור כלים מכילים של מכשירים ניידים בלבד: רשימה של מזהי כללים להפעלת פקודות מאקרו מותנות; המאקרו מופעל אם אחד מכללי ההפעלה מתקיים וכל כללי ההשבתה אינם נכונים. מטופל כקבוצה לא ממוינת. | |
macro[].fingerprint |
string |
טביעת האצבע של המאקרו GTM כפי שמחושב בזמן האחסון. הערך הזה מחושב מחדש בכל פעם שמתבצע שינוי במאקרו. | |
macro[].macroId |
string |
מזהה המאקרו מזהה באופן ייחודי את המאקרו של GTM. | |
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 |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
macro[].parameter[].value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
macro[].parentFolderId |
string |
המזהה של תיקיית ההורה. | |
macro[].scheduleEndMs |
long |
חותמת הזמן של הסיום, באלפיות השנייה, לתזמון מאקרו. | |
macro[].scheduleStartMs |
long |
חותמת הזמן של ההתחלה באלפיות השנייה לתזמון מאקרו. | |
macro[].type |
string |
סוג המאקרו GTM. | |
name |
string |
השם המוצג של גרסת הקונטיינר. | ניתן לכתיבה |
notes |
string |
הערות משתמש לגבי אופן ההחלה של גרסה זו של כלי הקיבול. | ניתן לכתיבה |
rule[] |
list |
הכללים במאגר התגים שממנו נלקחה הגרסה הזו. | |
rule[].accountId |
string |
מספר חשבון GTM. | |
rule[].condition[] |
list |
רשימת התנאים שמרכיבים את הכלל הזה (משתמע AND) ביניהם). | |
rule[].condition[].parameter[] |
list |
רשימה של פרמטרים בעלי שם (מפתח/ערך), בהתאם לסוג התנאי. הערות:
|
ניתן לכתיבה |
rule[].condition[].parameter[].key |
string |
המפתח בעל השם שמזהה פרמטר באופן ייחודי. נדרש לפרמטרים ברמה העליונה, וגם לערכי מפה. המערכת התעלמה מערכים ברשימה. | ניתן לכתיבה |
rule[].condition[].parameter[].list[] |
list |
הפרמטרים של פרמטר הרשימה הזו (המערכת תתעלם מהמפתחות). | ניתן לכתיבה |
rule[].condition[].parameter[].map[] |
list |
הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). | ניתן לכתיבה |
rule[].condition[].parameter[].type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
rule[].condition[].parameter[].value |
string |
ערך של פרמטר (עשוי להכיל הפניות למשתנים כגון "") בהתאם לסוג שצוין. | ניתן לכתיבה |
rule[].condition[].type |
string |
סוג האופרטור של התנאי הזה.
הערכים הקבילים הם:
|
ניתן לכתיבה |
rule[].containerId |
string |
מזהה מאגר תגים של GTM. | |
rule[].fingerprint |
string |
טביעת האצבע של כלל GTM, כפי שמחושב בזמן האחסון. הערך הזה יחושב מחדש בכל פעם שהכלל ישתנה. | |
rule[].name |
string |
השם המוצג של הכלל. | |
rule[].notes |
string |
המשתמש מציין איך להחיל את הכלל הזה בכלי הקיבול. | |
rule[].ruleId |
string |
מזהה הכלל הוא המזהה הייחודי של כלל GTM. | |
tag[] |
list |
התגים במאגר התגים שממנו נלקחה הגרסה הזו. | |
trigger[] |
list |
הטריגרים במאגר התגים שממנו נלקחה הגרסה הזו. | |
variable[] |
list |
המשתנים במאגר שמהם נלקחה הגרסה הזו. |
שיטות
- ליצור
- יוצר גרסה של מאגר.
- מחיקה
- מוחק גרסה של מאגר.
- מקבלים
- מקבל גרסה של מאגר.
- list
- פירוט של כל הגרסאות של מאגר תגים של GTM.
- publish
- מפרסמת גרסה של מאגר.
- לשחזר
- שחזור גרסה של כלי קיבול. הפעולה הזו תחליף את ההגדרה הנוכחית של המאגר (כולל המשתנים, הטריגרים והתגים שלו). לפעולה לא תהיה כל השפעה על הגרסה שמוצגת (כלומר הגרסה שפורסמה).
- undelete
- מבטל את המחיקה של גרסה של מאגר.
- עדכון
- מתבצע עדכון של גרסה של מאגר.