Tags: update

עדכון תג GTM. רוצים לנסות עכשיו?

בקשה

בקשת HTTP

PUT https://www.googleapis.com/tagmanager/v2/path

פרמטרים

שם הפרמטר ערך תיאור
פרמטרים של נתיב
path string הנתיב היחסי של ה-API של תג GTM. דוגמה: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/tags/{tag_id}
פרמטרים אופציונליים של שאילתה
fingerprint string כשמציינים את טביעת האצבע, היא צריכה להתאים לטביעת האצבע של התג אחסון.

אישור

הבקשה הזו מחייבת הרשאה עם ההיקף הבא:

היקף
https://www.googleapis.com/auth/tagmanager.edit.containers

מידע נוסף זמין בדף אימות והרשאה.

גוף הבקשה

בגוף הבקשה, מציינים משאב תגים עם המאפיינים הבאים:

שם הנכס ערך תיאור הערות
המאפיינים הנדרשים
consentSettings.consentType.type string סוג הפרמטר הערכים החוקיים הם:
  • boolean: הערך מייצג ערך בוליאני, שמיוצג כ-'true'. או 'false'
  • integer: הערך מייצג ערך של מספר שלם חתום של 64 ביט, בבסיס 10
  • list: יש לציין רשימת פרמטרים
  • map: יש לציין מפה של פרמטרים
  • template: הערך מייצג כל טקסט שהוא. כתובת זו יכולה לכלול הפניות למשתנים (גם הפניות למשתנים שעשויות להחזיר סוגים שאינם מחרוזות)
  • trigger_reference: הערך מייצג טריגר, שמיוצג כמזהה הטריגר
  • tag_reference: הערך מייצג תג שמיוצג כשם התג


הערכים הקבילים הם:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 ניתן לכתיבה
monitoringMetadata.type string סוג הפרמטר הערכים החוקיים הם:
  • boolean: הערך מייצג ערך בוליאני, שמיוצג כ-'true'. או 'false'
  • integer: הערך מייצג ערך של מספר שלם חתום של 64 ביט, בבסיס 10
  • list: יש לציין רשימת פרמטרים
  • map: יש לציין מפה של פרמטרים
  • template: הערך מייצג כל טקסט שהוא. כתובת זו יכולה לכלול הפניות למשתנים (גם הפניות למשתנים שעשויות להחזיר סוגים שאינם מחרוזות)
  • trigger_reference: הערך מייצג טריגר, שמיוצג כמזהה הטריגר
  • tag_reference: הערך מייצג תג שמיוצג כשם התג


הערכים הקבילים הם:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 ניתן לכתיבה
name string השם המוצג של התג. ניתן לכתיבה
parameter[].type string סוג הפרמטר הערכים החוקיים הם:
  • boolean: הערך מייצג ערך בוליאני, שמיוצג כ-'true'. או 'false'
  • integer: הערך מייצג ערך של מספר שלם חתום של 64 ביט, בבסיס 10
  • list: יש לציין רשימת פרמטרים
  • map: יש לציין מפה של פרמטרים
  • template: הערך מייצג כל טקסט שהוא. כתובת זו יכולה לכלול הפניות למשתנים (גם הפניות למשתנים שעשויות להחזיר סוגים שאינם מחרוזות)
  • trigger_reference: הערך מייצג טריגר, שמיוצג כמזהה הטריגר
  • tag_reference: הערך מייצג תג שמיוצג כשם התג


הערכים הקבילים הם:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 ניתן לכתיבה
priority.type string סוג הפרמטר הערכים החוקיים הם:
  • boolean: הערך מייצג ערך בוליאני, שמיוצג כ-'true'. או 'false'
  • integer: הערך מייצג ערך של מספר שלם חתום של 64 ביט, בבסיס 10
  • list: יש לציין רשימת פרמטרים
  • map: יש לציין מפה של פרמטרים
  • template: הערך מייצג כל טקסט שהוא. כתובת זו יכולה לכלול הפניות למשתנים (גם הפניות למשתנים שעשויות להחזיר סוגים שאינם מחרוזות)
  • trigger_reference: הערך מייצג טריגר, שמיוצג כמזהה הטריגר
  • tag_reference: הערך מייצג תג שמיוצג כשם התג


הערכים הקבילים הם:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 ניתן לכתיבה
type string סוג התג של GTM. ניתן לכתיבה
מאפיינים אופציונליים
blockingRuleId[] list מזהים של כללי חסימה. אם הערך של אחד מהכללים שברשימה הוא True, התג לא יופעל. ניתן לכתיבה
blockingTriggerId[] list חסימת מזהי טריגרים. אם אחד מהטריגרים שברשימה הוא True, התג לא יופעל. ניתן לכתיבה
consentSettings nested object הגדרות ההסכמה בתג. ניתן לכתיבה
consentSettings.consentType.key string המפתח בעל השם שמזהה את הפרמטר באופן ייחודי. חובה לפרמטרים ברמה העליונה וגם לערכי מפה. המערכת התעלמה מערכי הרשימה. ניתן לכתיבה
consentSettings.consentType.list[] list הפרמטרים של הפרמטר ברשימה הזו (המערכת תתעלם ממפתחות). ניתן לכתיבה
consentSettings.consentType.map[] list הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). ניתן לכתיבה
consentSettings.consentType.value string ערך של פרמטר (עשוי להכיל הפניות למשתנים כמו "") בהתאם לסוג שצוין. ניתן לכתיבה
firingRuleId[] list מזהי כללי הפעלה. תג יופעל כשאחד מהכללים המפורטים מתקיים וכל blockingRuleIds שלו (אם צוין) לא נכון. ניתן לכתיבה
firingTriggerId[] list מזהי טריגרים. תג יופעל כשאחד מהטריגרים שצוינו יתקיים וכל blockingTriggerIds שלו (אם צוין) מוגדר כ-False. ניתן לכתיבה
liveOnly boolean אם הוא מוגדר כ-True, התג הזה יופעל רק בסביבה הפעילה (למשל, לא במצב תצוגה מקדימה או במצב ניפוי באגים). ניתן לכתיבה
monitoringMetadata nested object מפה של צמדי מפתח/ערך של מטא-נתונים של תג שייכללו בנתוני האירועים לצורך מעקב אחרי תגים. הערות:
  • הפרמטר הזה חייב להיות מסוג MAP.
  • כל פרמטר במפה הוא מסוג TEMPLATE, אבל הוא לא יכול לכלול הפניות למשתנים.
 ניתן לכתיבה
monitoringMetadata.key string המפתח בעל השם שמזהה את הפרמטר באופן ייחודי. חובה לפרמטרים ברמה העליונה וגם לערכי מפה. המערכת התעלמה מערכי הרשימה. ניתן לכתיבה
monitoringMetadata.list[] list הפרמטרים של הפרמטר ברשימה הזו (המערכת תתעלם ממפתחות). ניתן לכתיבה
monitoringMetadata.map[] list הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). ניתן לכתיבה
monitoringMetadata.value string ערך של פרמטר (עשוי להכיל הפניות למשתנים כמו "") בהתאם לסוג שצוין. ניתן לכתיבה
monitoringMetadataTagNameKey string אם השדה לא ריק, השם המוצג של התג ייכלל במפת המטא-נתונים למעקב באמצעות המפתח שצוין. ניתן לכתיבה
notes string הערות משתמש לגבי אופן ההחלה של התג הזה במאגר. ניתן לכתיבה
parameter[] list הפרמטרים של התג ניתן לכתיבה
parameter[].key string המפתח בעל השם שמזהה את הפרמטר באופן ייחודי. חובה לפרמטרים ברמה העליונה וגם לערכי מפה. המערכת התעלמה מערכי הרשימה. ניתן לכתיבה
parameter[].list[] list הפרמטרים של הפרמטר ברשימה הזו (המערכת תתעלם ממפתחות). ניתן לכתיבה
parameter[].map[] list הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). ניתן לכתיבה
parameter[].value string ערך של פרמטר (עשוי להכיל הפניות למשתנים כמו "") בהתאם לסוג שצוין. ניתן לכתיבה
paused boolean בעמודה הזו מציינים אם התג מושהה, ולכן הוא לא יופעל. ניתן לכתיבה
priority nested object העדיפות המספרית של התג, שהוגדרה על ידי המשתמש. התגים מופעלים באופן אסינכרוני לפי סדר העדיפות. תגים עם ערך מספרי גבוה יותר מופעלים ראשונים. עדיפות של תג יכולה להיות ערך חיובי או שלילי. ערך ברירת המחדל הוא 0. ניתן לכתיבה
priority.key string המפתח בעל השם שמזהה את הפרמטר באופן ייחודי. חובה לפרמטרים ברמה העליונה וגם לערכי מפה. המערכת התעלמה מערכי הרשימה. ניתן לכתיבה
priority.list[] list הפרמטרים של הפרמטר ברשימה הזו (המערכת תתעלם ממפתחות). ניתן לכתיבה
priority.map[] list הפרמטרים של פרמטר המפה הזה (חייבים לכלול מפתחות, המפתחות חייבים להיות ייחודיים). ניתן לכתיבה
priority.value string ערך של פרמטר (עשוי להכיל הפניות למשתנים כמו "") בהתאם לסוג שצוין. ניתן לכתיבה
scheduleEndMs long חותמת הזמן של הסיום באלפיות השנייה כדי לתזמן תג. ניתן לכתיבה
scheduleStartMs long חותמת הזמן של ההתחלה באלפיות השנייה כדי לתזמן תג. ניתן לכתיבה

תשובה

אם הפעולה בוצעה ללא שגיאות, השיטה הזו תחזיר משאב Tags בגוף התגובה.

נסה בעצמך!

אפשר להשתמש ב-APIs Explorer שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.