Container Versions

גרסאות הקונטיינר של הקונטיינר. גרסת קונטיינר יכולה להיחשב כעותק שלא ניתן לשינוי (תמונת מצב) של תצורת קונטיינר בנקודת זמן מסוימת. יצירת גרסה חדשה באמצעות השיטה create תיצור גרסה המבוססת על התצורה הנוכחית (כלומר, פקודות המאקרו, הכללים והתגים של מאגר התגים). השיטה restore תשחזר את תצורת המאגר באמצעות הגרסה שצוינה. ה-method update מאפשרת לעדכן את השדות name ו-notes של הגרסה. כדי לאחזר את הגרסה הנוכחית שמפורסמת, משתמשים בשיטה get ומציינים את published עבור containerVersionId.

רשימה של ה-methods במשאב הזה מופיעה בסוף הדף.

ייצוגי משאבים

מייצג גרסת מאגר תגים של 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
}

שם הנכס	ערך	תיאור	הערות
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	רשימת התנאים שמרכיבים את הכלל הזה (משתמע וגם מהם).
rule[].condition[].parameter[]	list	רשימה של פרמטרים בעלי שם (מפתח/ערך), בהתאם לסוג התנאי. הערות: עבור אופרטורים בינאריים, יש לכלול פרמטרים בשם arg0 ו-arg1 כדי לציין את האופרנדים השמאליים והימניים, בהתאמה. בשלב הזה, האופרנד השמאלי (arg0) חייב להיות הפניה למשתנה. להתאמת ביטויים רגולריים (regex) לא תלויי-רישיות, צריך לכלול פרמטר בוליאני בשם ignore_case שמוגדר ל-true. אם לא תציינו ערך אחר או אם תגדירו ערך אחר, ההתאמה תהיה תלוית אותיות רישיות (case-sensitive). כדי לבטל אופרטור, צריך לכלול פרמטר בוליאני בשם 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.

לפרסם

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

לשחזר

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

ביטול מחיקה

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

עדכון

מעדכנת גרסה של מאגר תגים.