REST Resource: labels.permissions

Ressource: LabelPermission

Die Berechtigung, die für ein Hauptkonto (Nutzer, Gruppe, Zielgruppe) auf einem Label 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 des Hauptnutzers oder der Hauptgruppe der Gruppe an. Wird für Hauptkonten der Zielgruppe nicht ausgefüllt. Nutzer- und Gruppenberechtigungen können nur unter Verwendung einer E-Mail-Adresse eingefügt werden. Bei Aktualisierungsanfragen sollte kein Hauptkonto angegeben werden, wenn eine E-Mail-Adresse angegeben ist.
role

enum (LabelRole)

Die Rolle, die das Hauptkonto haben sollte.
Union-Feld principal. Das Hauptkonto, für das diese Berechtigung gilt. Muss eine E-Mail-Adresse, ein Nutzer, eine Gruppe oder eine Zielgruppe sein. Beispiel: * Personen/12345 * Gruppen/45678 * Zielgruppen/Standard-principal kann nur einer der folgenden Werte sein:
person

string

Name der Personenressource.
group

string

Name der Gruppenressource.
audience

string

Zielgruppe, der eine Rolle zugewiesen werden soll. Der magische Wert von audiences/default kann verwendet werden, um die Rolle auf die Standardzielgruppe im Kontext der Organisation anzuwenden, zu der das Label gehört.

LabelRole

Rollen sind mit nachfolgenden Rollen konzentrisch.

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 Anwender kann verknüpfte Metadaten zu Drive-Elementen schreiben, auf die er auch Schreibzugriff hat. Impliziert READER.
ORGANIZER Ein Organisator kann dieses Label in geteilten Ablagen anheften, die er verwaltet, und dem Label neue Anwender hinzufügen.
EDITOR Bearbeiter können beliebige Änderungen vornehmen und z. B. das Label löschen. 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.