Method: labels.revisions.permissions.batchUpdate
تحديثات التصنيفات. في حال عدم توفُّر إذن للمشرف المُشار إليه، يتم إنشاء إذن تصنيف جديد، وإلا سيتم تعديل الإذن الحالي. تؤثر الأذونات في مورد "التصنيف" بأكمله، ولا تتم مراجعتها، ولا تتطلب النشر.
طلب HTTP
POST https://drivelabels.googleapis.com/v2beta/{parent=labels/*/revisions/*}/permissions:batchUpdate
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. اسم مورد "التصنيف الرئيسي" الذي تتم مشاركته من خلال جميع الأذونات التي يتم تعديلها. التنسيق: التصنيفات/{label} إذا تم ضبط هذا الإعداد، يجب أن يكون الحقل الرئيسي في رسائل UpdateLabelPermissionRequest فارغًا أو مطابقًا لهذا الحقل.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"requests": [
{
object (UpdateLabelPermissionRequest)
}
],
"useAdminAccess": boolean
} |
| الحقول |
requests[] |
object (UpdateLabelPermissionRequest)
مطلوب. رسالة الطلب التي تحدد الموارد المطلوب تحديثها.
|
useAdminAccess |
boolean
يجب ضبط القيمة على true لاستخدام بيانات اعتماد المشرف الخاصة بالمستخدم. سيتحقّق الخادم من أنّ المستخدم مشرف للتصنيف قبل السماح بالوصول إليه. وإذا تم ضبط السياسة، يجب أن يكون الحقل useAdminAccess في رسائل UpdateLabelPermissionRequest فارغًا أو يتطابق مع هذا الحقل.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال 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-09-04 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-04 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Updates permissions for a Drive 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 do not need publishing."],["The API request requires specifying the parent Label resource and providing an array of update requests."],["You can use admin credentials for the update by setting the `useAdminAccess` field to true."],["Successful responses return a `BatchUpdateLabelPermissionsResponse` object."]]],["This outlines the process for updating Label permissions via a `POST` request to `https://drivelabels.googleapis.com/v2beta/{parent=labels/*/revisions/*}/permissions:batchUpdate`. The request requires a `parent` path parameter specifying the Label resource. The request body uses JSON, containing an array of `UpdateLabelPermissionRequest` objects and an optional `useAdminAccess` boolean. Successful requests return a `BatchUpdateLabelPermissionsResponse`. The operation requires specific OAuth scopes and admin privileges if the `useAdminAccess` field is true.\n"]]
