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 |
يمكن للمنظِّم تثبيت هذا التصنيف في مساحات Drive المشتركة التي يديرها وإضافة مستخدمين جدد لتطبيق التصنيف. |
EDITOR |
يمكن للمحرّرين إجراء أي تعديل، بما في ذلك حذف التصنيف الذي يؤدي أيضًا إلى حذف البيانات الوصفية لعنصر Drive المرتبط. يشير إلى APPLIER . |
الطُرق |
|
يحذف أذونات التصنيفات. |
|
تعديل أذونات التصنيفات |
|
تعديل أذونات تصنيف |
|
يحذف هذا الإجراء إذن التصنيف. |
|
تعرض هذه الطريقة أذونات التصنيف. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-05 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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/v2/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 principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified. |\n| `role` | `enum (`[LabelRole](/workspace/drive/labels/reference/rest/v2/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/v2/labels.permissions/batchDelete) | Deletes label permissions. |\n| ### [batchUpdate](/workspace/drive/labels/reference/rest/v2/labels.permissions/batchUpdate) | Updates label permissions. |\n| ### [create](/workspace/drive/labels/reference/rest/v2/labels.permissions/create) | Updates a label's permissions. |\n| ### [delete](/workspace/drive/labels/reference/rest/v2/labels.permissions/delete) | Deletes a label's permission. |\n| ### [list](/workspace/drive/labels/reference/rest/v2/labels.permissions/list) | Lists a label's permissions. |"]]