REST Resource: labels.permissions
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المورد: LabelPermission
الإذن الذي ينطبق على مبدأ أساسي (مستخدم أو مجموعة أو جمهور) في تصنيف
تمثيل JSON |
{
"name": string,
"email": string,
"role": enum (LabelRole ),
// Union field principal can be only one of the following:
"person": string,
"group": string,
"audience": string
// End of list of possible types for union field principal .
} |
الحقول |
name |
string
اسم المورد لهذا الإذن
|
email |
string
تُحدِّد عنوان البريد الإلكتروني لمدير مستخدم أو مجموعة. لا تتم تعبئة هذا الحقل لعناصر الجمهور الرئيسية. لا يمكن إدراج أذونات المستخدم والمجموعة إلا باستخدام عنوان البريد الإلكتروني. في طلبات التعديل، إذا تم تحديد عنوان البريد الإلكتروني، يجب عدم تحديد أيّ مشرف.
|
role |
enum (LabelRole )
الدور الذي يجب أن يحصل عليه المستخدم الأساسي
|
حقل الربط principal المستخدم الرئيسي الذي ينطبق عليه هذا الإذن يجب أن يكون عنوان بريد إلكتروني أو مستخدم أو مجموعة أو جمهور. مثال: * people/12345 * groups/45678 * audiences/default principal يمكن أن يكون واحدًا فقط مما يلي: |
person |
string
اسم مورد الشخص
|
group |
string
اسم مورد المجموعة
|
audience |
string
شريحة الجمهور التي تريد منح دور لها. يمكن استخدام القيمة السحرية audiences/default لتطبيق الدور على شريحة الجمهور التلقائية في سياق المؤسسة التي تملك التصنيف.
|
LabelRole
تكون الأدوار متداخلة مع الدور التالي.
عمليات التعداد |
LABEL_ROLE_UNSPECIFIED |
دور غير معروف |
READER |
يمكن للقارئ قراءة التصنيف والبيانات الوصفية المرتبطة به والمُطبَّقة على عناصر Drive. |
APPLIER |
يمكن لمقدّم الطلب كتابة بيانات وصفية مرتبطة بعناصر Drive التي يملك إذن الوصول للكتابة فيها أيضًا. يشير إلى READER . |
ORGANIZER |
يمكن للمنسِق تثبيت هذا التصنيف في مساحات التخزين السحابي المشتركة التي يديرها وإضافة مستخدمين جدد يطبّقون التصنيف. |
EDITOR |
يمكن للمحرِّرين إجراء أي تعديل، بما في ذلك حذف التصنيف الذي يؤدي أيضًا إلى حذف البيانات الوصفية المرتبطة بعنصر Drive. يشير إلى APPLIER . |
الطُرق |
|
حذف أذونات التصنيفات |
|
تعديل أذونات التصنيف |
|
تعديل أذونات التصنيف |
|
لحذف إذن تصنيف |
|
يسرد أذونات التصنيف. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# REST Resource: labels.permissions\n\n- [Resource: LabelPermission](#LabelPermission)\n - [JSON representation](#LabelPermission.SCHEMA_REPRESENTATION)\n - [LabelRole](#LabelPermission.LabelRole)\n- [Methods](#METHODS_SUMMARY)\n\nResource: LabelPermission\n-------------------------\n\nThe permission that applies to a principal (user, group, audience) on a label.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"email\": string, \"role\": enum (/workspace/drive/labels/reference/rest/v2beta/labels.permissions#LabelPermission.LabelRole), // Union field `principal` can be only one of the following: \"person\": string, \"group\": string, \"audience\": string // End of list of possible types for union field `principal`. } ``` |\n\n| Fields ||\n|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name of this permission. |\n| `email` | `string` Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified. |\n| `role` | `enum (`[LabelRole](/workspace/drive/labels/reference/rest/v2beta/labels.permissions#LabelPermission.LabelRole)`)` The role the principal should have. |\n| Union field `principal`. The principal this permission applies to. Must be either an email, user, group, or audience. Example: \\* people/12345 \\* groups/45678 \\* audiences/default `principal` can be only one of the following: ||\n| `person` | `string` Person resource name. |\n| `group` | `string` Group resource name. |\n| `audience` | `string` Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label. |\n\n### LabelRole\n\nRoles are concentric with subsequent role.\n\n| Enums ||\n|--------------------------|------------------------------------------------------------------------------------------------------------------------------------|\n| `LABEL_ROLE_UNSPECIFIED` | Unknown role. |\n| `READER` | A reader can read the label and associated metadata applied to Drive items. |\n| `APPLIER` | An applier can write associated metadata on Drive items in which they also have write access to. Implies `READER`. |\n| `ORGANIZER` | An organizer can pin this label in shared drives they manage and add new appliers to the label. |\n| `EDITOR` | Editors can make any update including deleting the label which also deletes the associated Drive item metadata. Implies `APPLIER`. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------------------------|--------------------------------|\n| ### [batchDelete](/workspace/drive/labels/reference/rest/v2beta/labels.permissions/batchDelete) | Deletes Label permissions. |\n| ### [batchUpdate](/workspace/drive/labels/reference/rest/v2beta/labels.permissions/batchUpdate) | Updates Label permissions. |\n| ### [create](/workspace/drive/labels/reference/rest/v2beta/labels.permissions/create) | Updates a Label's permissions. |\n| ### [delete](/workspace/drive/labels/reference/rest/v2beta/labels.permissions/delete) | Deletes a Label's permission. |\n| ### [list](/workspace/drive/labels/reference/rest/v2beta/labels.permissions/list) | Lists a Label's permissions. |"]]