REST Resource: labels.permissions

Resource: LabelPermission

The permission that applies to a principal (user, group, audience) on a label.

JSON representation
{
  "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.
}
Fields
name

string

Resource name of this permission.

email

string

Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified.

role

enum (LabelRole)

The role the principal should have.

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:
person

string

Person resource name.

group

string

Group resource name.

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.

LabelRole

Roles are concentric with subsequent role.

Enums
LABEL_ROLE_UNSPECIFIED Unknown role.
READER A reader can read the label and associated metadata applied to Drive items.
APPLIER An applier can write associated metadata on Drive items in which they also have write access to. Implies READER.
ORGANIZER An organizer can pin this label in shared drives they manage and add new appliers to the label.
EDITOR Editors can make any update including deleting the label which also deletes the associated Drive item metadata. Implies APPLIER.

Methods

batchDelete

Deletes Label permissions.

batchUpdate

Updates Label permissions.

create

Updates a Label's permissions.

delete

Deletes a Label's permission.

list

Lists a Label's permissions.

patch

Updates a Label's permissions.