REST Resource: labels.permissions
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recurso: LabelPermission
A permissão que se aplica a uma principal (usuário, grupo, público-alvo) em um rótulo.
| Representação 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.
} |
| Campos |
name |
string
Nome do recurso dessa permissão.
|
email |
string
Especifica o endereço de e-mail de um usuário ou principal de grupo. Não é preenchido para principais públicos-alvo. As permissões de usuário e grupo só podem ser inseridas usando um endereço de e-mail. Em solicitações de atualização, se o endereço de e-mail for especificado, nenhum principal poderá ser especificado.
|
role |
enum (LabelRole)
A função que a conta principal precisa ter.
|
Campo de união principal. O principal a que essa permissão se aplica. Precisa ser um e-mail, usuário, grupo ou público-alvo. Exemplo: * people/12345 * groups/45678 * audiences/default principal pode ser apenas um dos seguintes: |
person |
string
Nome do recurso de pessoa.
|
group |
string
Nome do recurso do grupo.
|
audience |
string
Público-alvo a que será concedida uma função. O valor mágico audiences/default pode ser usado para aplicar a função ao público-alvo padrão no contexto da organização proprietária do rótulo.
|
LabelRole
Os papéis são concêntricos com o papel subsequente.
| Enums |
LABEL_ROLE_UNSPECIFIED |
Função desconhecida. |
READER |
Um leitor pode ler o marcador e os metadados associados aplicados aos itens do Drive. |
APPLIER |
Um aplicador pode gravar metadados associados em itens do Drive em que também tem acesso de gravação. Implica READER. |
ORGANIZER |
Um organizador pode fixar esse marcador nos drives compartilhados que gerencia e adicionar novos aplicadores a ele. |
EDITOR |
Os editores podem fazer qualquer atualização, incluindo a exclusão do rótulo, que também exclui os metadados associados do item do Drive. Implica APPLIER. |
Métodos |
|
|
Exclui permissões de marcador. |
|
|
Atualiza as permissões de marcador. |
|
|
Atualiza as permissões de um rótulo. |
|
|
Exclui a permissão de um marcador. |
|
|
Lista as permissões de um marcador. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-05 UTC.
[null,null,["Última atualização 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. |"]]
