REST Resource: labels.permissions
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recurso: LabelPermission
Es el permiso que se aplica a una principal (usuario, grupo o público) en una etiqueta.
| Representación 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
Es el nombre del recurso de este permiso.
|
email |
string
Especifica la dirección de correo electrónico de un principal de usuario o grupo. No se propaga para los principales del público. Los permisos de usuarios y grupos solo se pueden insertar con una dirección de correo electrónico. En las solicitudes de actualización, si se especifica la dirección de correo electrónico, no se debe especificar ningún principal.
|
role |
enum (LabelRole)
Es el rol que debería tener la principal.
|
Campo de unión principal. Es la principal a la que se aplica este permiso. Debe ser un correo electrónico, un usuario, un grupo o un público. Ejemplo: * people/12345 * groups/45678 * audiences/default principal solo puede ser una de las siguientes opciones: |
person |
string
Es el nombre del recurso de persona.
|
group |
string
Nombre del recurso del grupo.
|
audience |
string
Es el público al que se le otorgará un rol. El valor mágico de audiences/default se puede usar para aplicar el rol al público predeterminado en el contexto de la organización propietaria de la etiqueta.
|
LabelRole
Los roles son concéntricos con el rol subsiguiente.
| Enumeraciones |
LABEL_ROLE_UNSPECIFIED |
Rol desconocido. |
READER |
Un lector puede leer la etiqueta y los metadatos asociados que se aplican a los elementos de Drive. |
APPLIER |
Un aplicador puede escribir metadatos asociados en los elementos de Drive en los que también tiene acceso de escritura. Implica READER. |
ORGANIZER |
Un organizador puede fijar esta etiqueta en las unidades compartidas que administra y agregar nuevos aplicadores a la etiqueta. |
EDITOR |
Los editores pueden realizar cualquier actualización, incluido borrar la etiqueta, lo que también borra los metadatos del elemento de Drive asociado. Implica APPLIER. |
Métodos |
|
|
Borra los permisos de etiquetas. |
|
|
Actualiza los permisos de la etiqueta. |
|
|
Actualiza los permisos de una etiqueta. |
|
|
Borra el permiso de una etiqueta. |
|
|
Enumera los permisos de una etiqueta. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-05 (UTC)
[null,null,["Última actualización: 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. |"]]
