REST Resource: labels.permissions
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: LabelPermission
L'autorizzazione che si applica a un'entità (utente, gruppo, pubblico) su un'etichetta.
Rappresentazione 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 .
} |
Campi |
name |
string
Nome risorsa di questa autorizzazione.
|
email |
string
Specifica l'indirizzo email per un'entità utente o gruppo. Non compilato per i principali segmenti di pubblico. Le autorizzazioni di utenti e gruppi possono essere inserite solo utilizzando un indirizzo email. Nelle richieste di aggiornamento, se viene specificato l'indirizzo email, non deve essere specificata alcuna entità.
|
role |
enum (LabelRole )
Il ruolo che deve avere l'entità.
|
Campo unione principal . L'entità a cui si applica questa autorizzazione. Deve essere un'email, un utente, un gruppo o un segmento di pubblico. Esempio: * people/12345 * groups/45678 * audiences/default principal può essere solo uno dei seguenti: |
person |
string
Nome della risorsa persona.
|
group |
string
Nome della risorsa del gruppo.
|
audience |
string
Il pubblico a cui assegnare un ruolo. Il valore magico audiences/default può essere utilizzato per applicare il ruolo al segmento di pubblico predefinito nel contesto dell'organizzazione proprietaria dell'etichetta.
|
LabelRole
I ruoli sono concentrici con il ruolo successivo.
Enum |
LABEL_ROLE_UNSPECIFIED |
Ruolo sconosciuto. |
READER |
Un lettore può leggere l'etichetta e i metadati associati applicati agli elementi di Drive. |
APPLIER |
Un applicatore può scrivere metadati associati sugli elementi di Drive per i quali dispone anche dell'accesso in scrittura. Implica READER . |
ORGANIZER |
Un organizzatore può bloccare questa etichetta nei Drive condivisi che gestisce e aggiungere nuovi applicatori all'etichetta. |
EDITOR |
Gli editor possono apportare qualsiasi aggiornamento, inclusa l'eliminazione dell'etichetta, che comporta anche l'eliminazione dei metadati dell'elemento di Drive associato. Implica APPLIER . |
Metodi |
|
Elimina le autorizzazioni delle etichette. |
|
Aggiorna le autorizzazioni delle etichette. |
|
Aggiorna le autorizzazioni di un'etichetta. |
|
Elimina l'autorizzazione di un'etichetta. |
|
Elenca le autorizzazioni di un'etichetta. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-05 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]