Method: labels.publish

מפרסמים את כל השינויים בטיוטה בתווית. לאחר הפרסום, ייתכן שהתווית לא תחזור למצב הטיוטה שלה. מידע נוסף זמין בכתובת google.apps.drive.labels.v2.Lifecycle.

פרסום תווית יוביל לפרסום גרסה חדשה. כל הגרסאות הקודמות של הטיוטה יימחקו. גרסאות קודמות שפורסמו יישמרו, אבל הן כפופות למחיקה אוטומטית לפי הצורך.

לאחר הפרסום, חלק מהשינויים כבר לא מותרים. באופן כללי, נדחה כל שינוי שיבטל או יגרום להגבלות חדשות על המטא-נתונים הקיימים הקשורים לתווית. לדוגמה, השינויים הבאים בתווית יידחו אחרי פרסום התווית: * לא ניתן למחוק את התווית באופן ישיר. צריך להשבית אותה קודם, ואז למחוק אותה. * לא ניתן לשנות את Field.FieldType. * שינויים באפשרויות אימות השדות לא יכולים לדחות משהו שהתקבל קודם לכן. * הקטנת מספר הערכים המקסימלי.

בקשת HTTP

POST https://drivelabels.googleapis.com/v2beta/{name=labels/*}:publish

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
name

string

חובה. שם המשאב של התווית.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "languageCode": string
}
שדות
useAdminAccess

boolean

כדי להשתמש בפרטי הכניסה של האדמין של המשתמש צריך להגדיר את הערך true. השרת יאמת שהמשתמש הוא מנהל המערכת של התווית לפני שיתיר גישה.
writeControl

object (WriteControl)

שליטה על האופן שבו בקשות כתיבה מבוצעות. ברירת המחדל היא לא מוגדרת, והמשמעות היא שהכתיבה האחרונה מנצחת.
languageCode

string

קוד השפה BCP-47 שבו צריך להשתמש כדי להעריך תוויות של שדות שהותאמו לשוק המקומי. אם לא בחרת לעשות זאת, ייעשה שימוש בערכים בשפה שהוגדרה כברירת המחדל.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה מכיל מופע של Label.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

למידע נוסף, עיינו במדריך ההרשאות.