Method: labels.publish

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

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

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

בקשת HTTP

POST https://drivelabels.googleapis.com/v2/{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

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