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 можно использовать для назначения роли аудитории по умолчанию в контексте организации, которой принадлежит метка. |
МеткаРоль
Роли концентричны по отношению к последующей роли.
| Перечисления |
|---|
LABEL_ROLE_UNSPECIFIED | Неизвестная роль. |
READER | Читатель может прочитать метку и связанные с ней метаданные, примененные к элементам Диска. |
APPLIER | Пользователь может записывать связанные метаданные в элементы Диска, к которым у него также есть доступ на запись. Подразумевает READER . |
ORGANIZER | Организатор может закрепить эту метку на общих дисках, которыми он управляет, и добавить к метке новых пользователей. |
EDITOR | Редакторы могут вносить любые изменения, включая удаление метки, что также удаляет связанные метаданные элемента Диска. Подразумевает APPLIER . |
Методы |
|---|
| Удаляет разрешения на метки. |
| Обновляет разрешения меток. |
| Обновляет разрешения метки. |
| Удаляет разрешение метки. |
| Перечисляет разрешения метки. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-05 UTC.
[null,null,["Последнее обновление: 2025-08-05 UTC."],[],[],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. |"]]
