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 ممکن است برای اعمال نقش به مخاطب پیش‌فرض در زمینه سازمانی که دارای برچسب است، استفاده شود. |
نقش برچسب
نقش ها با نقش بعدی متحدالمرکز هستند.
| Enums |
|---|
LABEL_ROLE_UNSPECIFIED | نقش نامعلوم |
READER | خواننده می‌تواند برچسب و فراداده مرتبط اعمال شده روی موارد Drive را بخواند. |
APPLIER | یک اپلیکیشن می‌تواند ابرداده مرتبط را روی موارد Drive بنویسد که در آن‌ها نیز دسترسی نوشتن دارند. به READER دلالت دارد. |
ORGANIZER | یک سازمان‌دهنده می‌تواند این برچسب را در درایوهای مشترکی که مدیریت می‌کند پین کند و اعمال‌کننده‌های جدیدی را به برچسب اضافه کند. |
EDITOR | ویراستاران می‌توانند هر به‌روزرسانی را انجام دهند، از جمله حذف برچسب که متادیتای مورد Drive مرتبط را نیز حذف می‌کند. به معنی APPLIER است. |
روش ها |
|---|
| مجوزهای برچسب را حذف می کند. |
| مجوزهای برچسب را به روز می کند. |
| مجوزهای یک برچسب را به روز می کند. |
| مجوز یک برچسب را حذف می کند. |
| مجوزهای یک برچسب را فهرست می کند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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. |"]]
