Container Versions

גרסאות כלי הקיבול של כלי קיבול. ניתן לחשוב על גרסת מאגר כעותק (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	סוג הפרמטר. הערכים החוקיים הם: boolean: הערך מייצג בוליאני, מיוצג כ-true או כ-false integer: הערך מייצג ערך של מספר שלם חתום של 64 ביט, בבסיס 10 list: יש לציין רשימה של פרמטרים map: יש לציין מפה של פרמטרים template: הערך מייצג כל טקסט. הוא יכול לכלול הפניות למשתנים (גם הפניות למשתנים שעשויות להחזיר סוגים שאינם מחרוזות) trigger_reference: הערך מייצג טריגר, שמיוצג כמזהה הטריגר הערכים הקבילים הם: "boolean" "integer" "list" "map" "template" "triggerReference"	ניתן לכתיבה
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	רשימה של פרמטרים בעלי שם (מפתח/ערך), בהתאם לסוג התנאי. הערות: באופרטורים בינאריים, כוללים פרמטרים בשם arg0 ו-arg1 לציון האופרנד הימני והשמאלי, בהתאמה. בשלב זה, האופרנד השמאלי (arg0) חייב להיות הפניה למשתנה. לצורך התאמת ביטוי רגולרי (regex) שאינה תלוית-רישיות, יש לכלול פרמטר בוליאני בשם 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: הערך מייצג ערך של מספר שלם חתום של 64 ביט, בבסיס 10 list: יש לציין רשימה של פרמטרים map: יש לציין מפה של פרמטרים template: הערך מייצג כל טקסט. הוא יכול לכלול הפניות למשתנים (גם הפניות למשתנים שעשויות להחזיר סוגים שאינם מחרוזות) trigger_reference: הערך מייצג טריגר, שמיוצג כמזהה הטריגר הערכים הקבילים הם: "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.
rule[].fingerprint	string	טביעת האצבע של כלל GTM, כפי שמחושב בזמן האחסון. הערך הזה יחושב מחדש בכל פעם שהכלל ישתנה.
rule[].name	string	השם המוצג של הכלל.
rule[].notes	string	המשתמש מציין איך להחיל את הכלל הזה בכלי הקיבול.
rule[].ruleId	string	מזהה הכלל הוא המזהה הייחודי של כלל GTM.
tag[]	list	התגים במאגר התגים שממנו נלקחה הגרסה הזו.
trigger[]	list	הטריגרים במאגר התגים שממנו נלקחה הגרסה הזו.
variable[]	list	המשתנים במאגר שמהם נלקחה הגרסה הזו.

שיטות

ליצור

יוצר גרסה של מאגר.

מחיקה

מוחק גרסה של מאגר.

מקבלים

מקבל גרסה של מאגר.

list

פירוט של כל הגרסאות של מאגר תגים של GTM.

publish

מפרסמת גרסה של מאגר.

לשחזר

שחזור גרסה של כלי קיבול. הפעולה הזו תחליף את ההגדרה הנוכחית של המאגר (כולל המשתנים, הטריגרים והתגים שלו). לפעולה לא תהיה כל השפעה על הגרסה שמוצגת (כלומר הגרסה שפורסמה).

undelete

מבטל את המחיקה של גרסה של מאגר.

עדכון

מתבצע עדכון של גרסה של מאגר.