Method: labels.permissions.batchDelete
لحذف أذونات التصنيفات. تؤثر الأذونات في مورد "التصنيف" بأكمله، ولا تتم مراجعتها، ولا تتطلب النشر.
طلب HTTP
POST https://drivelabels.googleapis.com/v2beta/{parent=labels/*}/permissions:batchDelete
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
parent |
string
مطلوب. اسم مورد "التصنيف الرئيسي" الذي تتم مشاركته من خلال جميع الأذونات التي يتم حذفها. التنسيق: التصنيفات/{label} إذا تم ضبط هذا الإعداد، يجب أن يكون الحقل الرئيسي في رسائل UpdateLabelPermissionRequest فارغًا أو مطابقًا لهذا الحقل.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
الحقول |
requests[] |
object (DeleteLabelPermissionRequest )
مطلوب. رسالة الطلب التي تحدد الموارد المطلوب تحديثها.
|
useAdminAccess |
boolean
يجب ضبط القيمة على true لاستخدام بيانات اعتماد المشرف الخاصة بالمستخدم. سيتحقّق الخادم من أنّ المستخدم مشرف للتصنيف قبل السماح بالوصول إليه. وإذا تم تعيين هذا الحقل، فيجب أن يكون الحقل useAdminAccess في رسائل DeleteLabelPermissionRequest فارغًا أو مطابقًا لهذا الحقل.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.admin.labels
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
DeleteLabelPermissionRequest
حذف إذن تصنيف. تؤثر الأذونات في مورد "التصنيف" بأكمله، ولا تتم مراجعتها، ولا تتطلب النشر.
تمثيل JSON |
{
"name": string,
"useAdminAccess": boolean
} |
الحقول |
name |
string
مطلوب. اسم مورد إذن التصنيف.
|
useAdminAccess |
boolean
يجب ضبط القيمة على true لاستخدام بيانات اعتماد المشرف الخاصة بالمستخدم. سيتحقّق الخادم من أنّ المستخدم مشرف للتصنيف قبل السماح بالوصول إليه.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-10-11 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-10-11 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Deletes permissions for a Label, impacting the entire resource and not requiring revisions or publishing."],["Utilizes an HTTP POST request to `https://drivelabels.googleapis.com/v2beta/{parent=labels/*}/permissions:batchDelete` for batch deletion of permissions."],["Requires specifying the parent Label resource name and providing an array of DeleteLabelPermissionRequest objects in the request body."],["Offers an option to use admin credentials for the operation, enhancing control over permission management."],["Needs authorization with either `https://www.googleapis.com/auth/drive.labels` or `https://www.googleapis.com/auth/drive.admin.labels` scopes."]]],["This content outlines the process for batch deleting Label permissions via an API. It uses a `POST` HTTP request to `drivelabels.googleapis.com/v2beta/{parent=labels/*}/permissions:batchDelete`. The request body includes an array of `DeleteLabelPermissionRequest` objects, each specifying a permission's resource `name`. An optional `useAdminAccess` field in the request body or each message allows administrator credential use. Deletion requires `drive.labels` or `drive.admin.labels` OAuth scopes, and a successful operation results in an empty response body.\n"]]