Method: labels.permissions.batchUpdate
تحديثات التصنيفات. في حال عدم توفُّر إذن للمشرف المُشار إليه، يتم إنشاء إذن تصنيف جديد، وإلا سيتم تعديل الإذن الحالي. تؤثر الأذونات في مورد "التصنيف" بأكمله، ولا تتم مراجعتها، ولا تتطلب النشر.
طلب HTTP
POST https://drivelabels.googleapis.com/v2/{parent=labels/*}/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-10-11 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-10-11 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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"]]
