מפרסמים את כל השינויים בטיוטה בתווית. לאחר הפרסום, ייתכן שהתווית לא תחזור למצב הטיוטה שלה. מידע נוסף זמין בכתובת google.apps.drive.labels.v2.Lifecycle
.
פרסום תווית יוביל לפרסום גרסה חדשה. כל הגרסאות הקודמות של הטיוטה יימחקו. גרסאות קודמות שפורסמו יישמרו, אבל הן כפופות למחיקה אוטומטית לפי הצורך.
לאחר הפרסום, חלק מהשינויים כבר לא מותרים. באופן כללי, נדחה כל שינוי שיבטל או יגרום להגבלות חדשות על המטא-נתונים הקיימים הקשורים לתווית. לדוגמה, השינויים הבאים בתווית יידחו אחרי פרסום התווית: * לא ניתן למחוק את התווית באופן ישיר. צריך להשבית אותה קודם, ואז למחוק אותה. * לא ניתן לשנות את Field.FieldType. * שינויים באפשרויות אימות השדות לא יכולים לדחות משהו שהתקבל קודם לכן. * הקטנת מספר הערכים המקסימלי.
בקשת HTTP
POST https://drivelabels.googleapis.com/v2/{name=labels/*}:publish
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
name |
חובה. שם המשאב של התווית. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"useAdminAccess": boolean,
"writeControl": {
object ( |
שדות | |
---|---|
useAdminAccess |
כדי להשתמש בפרטי הכניסה של האדמין של המשתמש צריך להגדיר את הערך |
writeControl |
שליטה על האופן שבו בקשות כתיבה מבוצעות. ברירת המחדל היא לא מוגדרת, והמשמעות היא שהכתיבה האחרונה מנצחת. |
languageCode |
קוד השפה BCP-47 שבו צריך להשתמש כדי להעריך תוויות של שדות שהותאמו לשוק המקומי. אם לא בחרת לעשות זאת, ייעשה שימוש בערכים בשפה שהוגדרה כברירת המחדל. |
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה מכיל מופע של Label
.
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.admin.labels
למידע נוסף, עיינו במדריך ההרשאות.