REST Resource: labels.permissions
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource : LabelPermission
Autorisation qui s'applique à un compte principal (utilisateur, groupe, audience) sur un libellé.
Représentation 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 .
} |
Champs |
name |
string
Nom de ressource de cette autorisation.
|
email |
string
Spécifie l'adresse e-mail d'un utilisateur ou d'un groupe principal. Non renseigné pour les principaux d'audience. Les autorisations des utilisateurs et des groupes ne peuvent être insérées qu'à l'aide d'une adresse e-mail. Dans les demandes de mise à jour, si une adresse e-mail est spécifiée, aucun principal ne doit l'être.
|
role |
enum (LabelRole )
Rôle que l'entité principale doit avoir.
|
Champ d'union principal . Compte principal auquel s'applique cette autorisation. Il doit s'agir d'une adresse e-mail, d'un utilisateur, d'un groupe ou d'une audience. Exemple : * people/12345 * groups/45678 * audiences/default principal ne peut être que l'un des éléments suivants : |
person |
string
Nom de ressource de la personne.
|
group |
string
Nom de ressource du groupe.
|
audience |
string
Audience à laquelle attribuer un rôle. La valeur magique audiences/default peut être utilisée pour appliquer le rôle à l'audience par défaut dans le contexte de l'organisation propriétaire du libellé.
|
LabelRole
Les rôles sont concentriques avec le rôle suivant.
Enums |
LABEL_ROLE_UNSPECIFIED |
Rôle inconnu. |
READER |
Un lecteur peut lire le libellé et les métadonnées associées appliqués aux éléments Drive. |
APPLIER |
Un applicateur peut écrire des métadonnées associées sur les éléments Drive auxquels il a également accès en écriture. Implique READER . |
ORGANIZER |
Un organisateur peut épingler ce libellé dans les Drive partagés qu'il gère et ajouter de nouveaux utilisateurs à ce libellé. |
EDITOR |
Les éditeurs peuvent effectuer n'importe quelle modification, y compris supprimer le libellé, ce qui supprime également les métadonnées de l'élément Drive associé. Implique APPLIER . |
Méthodes |
|
Supprime les autorisations de libellé. |
|
Met à jour les autorisations des libellés. |
|
Met à jour les autorisations d'un libellé. |
|
Supprime l'autorisation d'un libellé. |
|
Liste les autorisations d'un libellé. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/05 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]