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