REST Resource: labels.permissions

Ressource: LabelPermission

Die Berechtigung, die für ein Hauptkonto (Nutzer, Gruppe, Zielgruppe) eines Labels gilt.

JSON-Darstellung
{
  "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.
}
Felder
name

string

Ressourcenname dieser Berechtigung.

email

string

Gibt die E-Mail-Adresse für einen Nutzer oder eine Gruppe an. Wird für Hauptkonten nicht ausgefüllt. Nutzer- und Gruppenberechtigungen können nur mit der E-Mail-Adresse eingefügt werden. Wenn bei Aktualisierungsanfragen eine E-Mail-Adresse angegeben ist, sollte kein Hauptkonto angegeben werden.

role

enum (LabelRole)

Die Rolle, die das Hauptkonto haben soll.

Union-Feld principal. Das Hauptkonto, für das diese Berechtigung gilt. Muss entweder eine E-Mail-Adresse, ein Nutzer, eine Gruppe oder eine Zielgruppe sein. Beispiel: * people/12345 * groups/45678 * Zielgruppen/Standard Bei principal kann nur einer der folgenden Werte angegeben werden:
person

string

Ressourcenname der Person.

group

string

Ressourcenname der Gruppe.

audience

string

Zielgruppe, der eine Rolle zugewiesen werden soll. Mit dem magischen Wert audiences/default kann die Rolle auf die Standardzielgruppe im Kontext der Organisation angewendet werden, der das Label gehört.

LabelRole

Rollen sind konzentrisch mit der nachfolgenden Rolle.

Enums
LABEL_ROLE_UNSPECIFIED Unbekannte Rolle.
READER Ein Leser kann das Label und die zugehörigen Metadaten lesen, die auf Drive-Elemente angewendet wurden.
APPLIER Ein Applier kann zugehörige Metadaten für Drive-Elemente schreiben, auf die er auch Schreibzugriff hat. Impliziert READER.
ORGANIZER Ein Organisator kann dieses Label in geteilten Ablagen anpinnen, die er verwaltet, und dem Label neue Anwendungen hinzufügen.
EDITOR Bearbeiter können alle Änderungen vornehmen, einschließlich des Löschens des Labels. Dadurch werden auch die zugehörigen Metadaten des Drive-Elements gelöscht. Impliziert APPLIER.

Methoden

batchDelete

Löscht Labelberechtigungen.

batchUpdate

Aktualisiert Labelberechtigungen.

create

Aktualisiert die Berechtigungen eines Labels.

delete

Löscht die Berechtigung eines Labels.

list

Listet die Berechtigungen eines Labels auf.