REST Resource: labels.permissions

Ressource: LabelPermission

Die Berechtigung, die für ein Hauptkonto (Nutzer, Gruppe, Zielgruppe) für ein 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 für ein Nutzer- oder Gruppenhauptkonto an. Wird für Zielgruppen-Principals nicht ausgefüllt. Nutzer- und Gruppenberechtigungen können nur über eine E-Mail-Adresse eingefügt werden. Bei Aktualisierungsanfragen darf kein Prinzipal angegeben werden, wenn eine E-Mail-Adresse angegeben ist.
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 * audiences/default principal kann nur einer der folgenden Werte sein:
person

string

Name der Personenressource.
group

string

Gruppenressourcenname.
audience

string

Zielgruppe, der eine Rolle zugewiesen werden soll. Der magische Wert audiences/default kann verwendet werden, um die Rolle auf die Standardzielgruppe im Kontext der Organisation anzuwenden, 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, für die er auch Schreibzugriff hat. Impliziert READER.
ORGANIZER Ein Organisator kann dieses Label in geteilten Ablagen, die er verwaltet, anpinnen und neue Nutzer hinzufügen, die das Label anwenden dürfen.
EDITOR Bearbeiter können beliebige Änderungen vornehmen, einschließlich des Löschens des Labels, wodurch auch die zugehörigen Drive-Elementmetadaten gelöscht werden. 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.