Method: labels.permissions.batchUpdate
הרשאות לתוויות עדכונים. אם לא קיימת הרשאה לחשבון המשתמש שצוין, נוצרת הרשאת תווית חדשה. אחרת, ההרשאה הקיימת תתעדכן. ההרשאות משפיעות על המשאב 'תווית' בשלמותו, הן לא מתוקנות ולא מחייבות פרסום.
בקשת HTTP
POST https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions:batchUpdate
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים |
parent |
string
חובה. שם המשאב של תווית ההורה, שמשותף לכל ההרשאות שמתעדכנות. פורמט: labels/{label} אם המדיניות הזו מוגדרת, שדה ההורה בהודעות UpdateLabelLabelRequest צריך להיות ריק או להתאים לשדה הזה.
|
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
{
"requests": [
{
object (UpdateLabelPermissionRequest )
}
],
"useAdminAccess": boolean
} |
שדות |
requests[] |
object (UpdateLabelPermissionRequest )
חובה. הודעת הבקשה שבה מפורטים המשאבים לעדכון.
|
useAdminAccess |
boolean
צריך להגדיר את הערך true כדי להשתמש בפרטי הכניסה של האדמין של המשתמש. השרת יאמת שהמשתמש הוא אדמין של התווית לפני שהוא יאפשר גישה. אם הגדרה זו, השדה useAdminAccess בהודעות של UpdateLabelLabelRequest צריך להיות ריק או להתאים לו.
|
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של BatchUpdateLabelPermissionsResponse
.
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.admin.labels
מידע נוסף זמין במדריך להרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-10-11 (שעון UTC).
[null,null,["עדכון אחרון: 2024-10-11 (שעון UTC)."],[[["Updates permissions for a Label, creating new ones if they don't exist and updating existing ones otherwise."],["Permissions apply to the entire Label resource, are not versioned, and don't need publishing."],["The request body should contain an array of `UpdateLabelPermissionRequest` objects and a `useAdminAccess` boolean."],["Requires authorization with either `https://www.googleapis.com/auth/drive.labels` or `https://www.googleapis.com/auth/drive.admin.labels` scopes."],["Successful responses return a `BatchUpdateLabelPermissionsResponse` object."]]],["This content describes updating Label permissions via a `POST` request to `https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions:batchUpdate`. The `parent` path parameter specifies the Label resource. The request body, in JSON format, includes an array of `UpdateLabelPermissionRequest` objects in `requests` and `useAdminAccess` field that allows using the admin credentials. The response is a `BatchUpdateLabelPermissionsResponse`. This action requires specific OAuth scopes: `drive.labels` or `drive.admin.labels`.\n"]]