Method: labels.enable

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

בקשת HTTP

POST https://drivelabels.googleapis.com/v2/{name=labels/*}:enable

בכתובת ה-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

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