עדכון תג 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 |
סוג הפרמטר הערכים החוקיים הם:
הערכים הקבילים הם:
|
ניתן לכתיבה |
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 |
מזהי טריגרים. תג יופעל כשאחד מהטריגרים שצוינו יתקיים וכל 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 |
חותמת הזמן של ההתחלה באלפיות השנייה כדי לתזמן תג. | ניתן לכתיבה |
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו תחזיר משאב Tags בגוף התגובה.
נסה בעצמך!
אפשר להשתמש ב-APIs Explorer שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.