מתבצע עדכון של תג GTM. רוצים לנסות עכשיו?
בקשה
בקשת HTTP
PUT https://www.googleapis.com/tagmanager/v2/path
פרמטרים
שם הפרמטר | Value | התיאור |
---|---|---|
פרמטרים של נתיב | ||
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 |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, מציינים משאב תגים עם המאפיינים הבאים:
שם הנכס | Value | התיאור | הערות |
---|---|---|---|
מאפיינים נדרשים | |||
consentSettings.consentType.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
monitoringMetadata.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
name |
string |
השם המוצג של התג. | ניתן לכתיבה |
parameter[].type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
priority.type |
string |
סוג הפרמטר. הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
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 |
הפעלת מזהים של טריגרים. תג יופעל כשכל אחד מהטריגרים שמופיעים ברשימה יהיה TRUE וכל ה-blockingTriggerIds שלו (אם צוין) false. |
ניתן לכתיבה |
liveOnly |
boolean |
אם המדיניות מוגדרת כ-True, התג יופעל רק בסביבה הפעילה (למשל, לא במצב תצוגה מקדימה או ניפוי באגים). | ניתן לכתיבה |
monitoringMetadata |
nested object |
מפה של צמדי מפתח/ערך של מטא-נתונים של תג שיש לכלול בנתוני האירוע לצורך מעקב אחר תגים. הערות:
|
ניתן לכתיבה |
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 |
חותמת הזמן של ההתחלה באלפיות השנייה לתזמון תג. | ניתן לכתיבה |
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה משאב תגים בגוף התגובה.
רוצה לנסות?
ניתן להשתמש ב-APIs Explorer שבהמשך כדי לקרוא לשיטה הזו בנתונים בזמן אמת ולראות את התגובה.