Workspaces: updateProposal

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

בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר Value התיאור
פרמטרים של נתיב
path string הנתיב היחסי של ההצעה ל-GTM ל-Workspace: דוגמה: accounts/{aid}/containers/{cid}/workspace/{wid}/workspace_proposal

גוף הבקשה

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

{
  "status": string,
  "reviewers": [
    {
      "type": string,
      "gaiaId": long
    }
  ],
  "newComment": {
    "content": string
  },
  "fingerprint": string
}
שם הנכס Value התיאור הערות
status string אם ההצעה קיימת, הסטטוס של ההצעה ל-Workspace מתעדכן.

הערכים הקבילים הם:
  • "approved"
  • "cancelled"
  • "completed"
  • "requested"
  • "reviewed"
  • "statusUnspecified"
reviewers[] list אם קיימת הצעה, רשימת הבודקים של ההצעה ל-Workspace מתעדכנת.
reviewers[].type string סוג המשתמש יוצר הבחנה בין משתמש למערכת Google Tag Manager.

הערכים הקבילים הם:
  • "gaiaId"
  • "system"
reviewers[].gaiaId long מזהה Gaia המשויך למשתמש, חסר במערכת Google Tag Manager.
newComment nested object אם יש תגובה חדשה, היא מתווספת להיסטוריית ההצעות לסביבת העבודה.
newComment.content string התוכן של כותב הביקורת או התגובה.
fingerprint string כשטביעת האצבע ניתנת, היא חייבת להיות תואמת לטביעת האצבע של ההצעה באחסון.

תשובה

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

{
  "path": string,
  "status": string,
  "authors": [
    {
      "type": string,
      "gaiaId": long
    }
  ],
  "reviewers": [
    {
      "type": string,
      "gaiaId": long
    }
  ],
  "history": [
    {
      "type": string,
      "comment": {
        "content": string
      },
      "statusChange": {
        "oldStatus": string,
        "newStatus": string
      },
      "createdBy": {
        "type": string,
        "gaiaId": long
      },
      "createdTimestamp": {
        "seconds": long,
        "nanos": integer
      }
    }
  ],
  "fingerprint": string
}
שם הנכס Value התיאור הערות
path string הנתיב היחסי של ההצעה לסביבת עבודה ב-GTM.
status string סטטוס ההצעה ל-Workspace בזמן שהיא עוברת בדיקה.

הערכים הקבילים הם:
  • "approved"
  • "cancelled"
  • "completed"
  • "requested"
  • "reviewed"
  • "statusUnspecified"
authors[] list רשימת המחברים להצעה ל-Workspace.
authors[].type string סוג המשתמש יוצר הבחנה בין משתמש למערכת Google Tag Manager.

הערכים הקבילים הם:
  • "gaiaId"
  • "system"
authors[].gaiaId long מזהה Gaia המשויך למשתמש, חסר במערכת Google Tag Manager.
reviewers[] list רשימות של בודקים להצעה ל-Workspace.
reviewers[].type string סוג המשתמש יוצר הבחנה בין משתמש למערכת Google Tag Manager.

הערכים הקבילים הם:
  • "gaiaId"
  • "system"
reviewers[].gaiaId long מזהה Gaia המשויך למשתמש, חסר במערכת Google Tag Manager.
history[] list תיעוד ההיסטוריה של התגובות ושינויים בסטטוס.
history[].type string סוג ההיסטוריה שמבדילה בין תגובות לבין שינויי סטטוס.

הערכים הקבילים הם:
  • "comment"
  • "statusChange"
  • "unspecified"
history[].comment nested object תגובה של משתמש או כותב ביקורת.
history[].comment.content string התוכן של כותב הביקורת או התגובה.
history[].statusChange nested object שינוי בסטטוס של ההצעה.
history[].statusChange.oldStatus string סטטוס ההצעה הישן לפני שינוי הסטטוס.

הערכים הקבילים הם:
  • "approved"
  • "cancelled"
  • "completed"
  • "requested"
  • "reviewed"
  • "statusUnspecified"
history[].statusChange.newStatus string סטטוס ההצעה החדש לאחר שינוי הסטטוס.

הערכים הקבילים הם:
  • "approved"
  • "cancelled"
  • "completed"
  • "requested"
  • "reviewed"
  • "statusUnspecified"
history[].createdBy nested object הגורם האחראי לשינוי בהיסטוריה.
history[].createdBy.type string סוג המשתמש יוצר הבחנה בין משתמש למערכת Google Tag Manager.

הערכים הקבילים הם:
  • "gaiaId"
  • "system"
history[].createdBy.gaiaId long מזהה Gaia המשויך למשתמש, חסר במערכת Google Tag Manager.
history[].createdTimestamp nested object כשאירוע ההיסטוריה הזה התווסף להצעה לסביבת עבודה.
history[].createdTimestamp.seconds long מייצג שניות של זמן UTC מאז epoch 1970-01-01T00:00:00Z של Unix. חייב להיות בין 0001-01-01T00:00:00Z ל-9999-12-31T23:59:59Z, כולל.
history[].createdTimestamp.nanos integer שברי שנייה לא שליליים ברזולוציה של ננו-שנייה. ערכים שליליים של שניות עם שברים עדיין חייבים לכלול ערכי ננו-שליליים שנספרות קדימה בזמן. חייב להיות בין 0 ל-999,999,999, כולל.
fingerprint string טביעת האצבע של ההצעה ל-GTM לסביבת העבודה, כפי שמחושבת בזמן האחסון. הערך הזה יחושב מחדש בכל פעם שההצעה תשתנה.

רוצה לנסות?

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