Drive Labels API – Übersicht

Labels sind Metadaten, die Sie definieren, damit Nutzer Dateien in Google Drive leichter sortieren, finden und Richtlinien darauf anwenden können. Die Drive Labels API ist eine RESTful API, die Geschäftsprozesse unterstützt, indem Ihren Drive-Dateien Metadaten hinzugefügt werden. Gängige Anwendungsfälle für diese API:

  • Inhalte gemäß einer Strategie zur Informationssteuerung klassifizieren: Sie können ein Label erstellen, um sensible Inhalte oder Daten zu kennzeichnen, die eine besondere Behandlung erfordern. Sie können beispielsweise ein Label mit einem Logo (ein Label mit farbcodierten Optionen) mit dem Titel „Vertraulichkeit“ und den Werten „Sehr geheim“, „Vertraulich“ und „Öffentlich“ erstellen.

  • Richtlinie auf Elemente in Drive anwenden: Sie können Labels erstellen, um Drive-Inhalte über ihren gesamten Lebenszyklus zu verwalten und dafür zu sorgen, dass sie den Aufbewahrungsrichtlinien Ihrer Organisation entsprechen. Sie können beispielsweise Labels verwenden, um eine Datenverlustpräventionsrichtlinie (DLP) zu verwalten, bei der Dateien mit dem Label „Vertraulichkeit“, das auf „Sehr geheim“ festgelegt ist, nicht auf einen Computer heruntergeladen werden können.

  • Dateien auswählen und finden: Sie können Labels erstellen, um die Suchbarkeit der Inhalte Ihres Unternehmens zu erhöhen. So können Nutzer in Ihrer Organisation Elemente anhand von Labels und deren Feldern finden. Beispiel: Eine Person in Ihrer Organisation könnte über die Suchoptionen in Google Drive alle Verträge finden, die bis zu einem bestimmten Datum zur Unterzeichnung bereitstehen.

Im Folgenden finden Sie eine Liste gängiger Begriffe, die in der Drive Labels API verwendet werden:

Label

Strukturierte Metadaten, die in einer Drive-Datei gespeichert sind. Drive-Nutzer können Dateien Labels zuweisen und Labelfeldwerte festlegen. Labels bestehen aus:

Label name
Der Ressourcenname des Labels. Die Label-ID ist Teil des Labelnamens. Je nach Anfrage hat der Name das Format labels/{id} oder labels/{id}@{revisionId}. Weitere Informationen finden Sie unten unter Labelüberarbeitung.
Label-ID
Eine global eindeutige Kennung für das Label. Die ID ist Teil des Labels, aber im Gegensatz zum Namen ist sie bei allen Versionen gleich.

Es gibt zwei Arten von Labels:

Badge-Label

Ein Label mit einem SelectionOptions-Feldtyp, der Auswahlmöglichkeiten enthält, die farblich codiert werden können, um die Wichtigkeit anzugeben. Dazu wird badgeConfig über das Properties eines Choice festgelegt.

In Google Drive wird für jede Datei die Farbe der ausgewählten Option angezeigt, damit Nutzer den Status, die Klassifizierung usw. der Datei leicht erkennen können. Die Option „Streng geheim“ für das Label „Sensitivität“ kann beispielsweise rot angezeigt werden. Sie können immer nur ein Label mit einem Badge haben.

Standard label

Ein Label mit null oder mehr Feldtypen. Ein Standardlabel kann einen Labeltitel wie „Projekt Mondlandung“ haben und alle mit dem Projekt verbundenen Dateien angeben. Ein Standardlabel kann auch mehrere strukturierte Felder haben. Ein Label mit dem Titel „Vertrag“ kann beispielsweise die Felder „Unternehmen“, „Fälligkeitsdatum“, „Status“ und „Unterzeichner“ enthalten. Jedes Feld hat einen bestimmten Typ (Text, Datum, Auswahl oder Nutzer).

Diagramm mit Badge-Label
Abbildung 1: Label mit Logo
Standard-Labeldiagramm.
Abbildung 2. Standard label
Feld

Eine einzelne typisierte, einstellbare Komponente eines Labels. Mit einem Label können null oder mehrere Felder verknüpft sein.

Feldtyp
Der Datentyp des Werts, der mit dem Feld verknüpft ist. Konfigurierbar als Text, Ganzzahl, Datum, Nutzer oder Auswahl. Wenn Sie das Feld mit ListOptions konfigurieren, können Sie die Nutzer- und Auswahlfelder mit mehreren Werten festlegen. Der ausgewählte Typ wirkt sich sowohl auf die gültigen Werte für Google Drive-Elemente als auch auf die verfügbaren Suchanfrageoptionen aus.
Choice

Eine von mehreren Optionen, die ein Nutzer in einem SelectionOptions-Feld auswählen kann.

Labeltyp

Alle Labels enthalten ein LabelType. Es gibt zwei Arten von Labels:

Administrator

Wenn Sie von Administratoren erstellte Labels erstellen und bearbeiten möchten, müssen Sie Kontoadministrator mit der Berechtigung Labels verwalten sein.

Administratoren können Administratorlabels für jeden Nutzer freigeben, damit dieser sie auf Drive-Elemente anwenden kann. Zum Ändern oder Lesen von Labelwerten für Drive-Elemente sind die folgenden Berechtigungen erforderlich:

  • Ändern: Damit ein Nutzer die Drive-Elementmetadaten zu einem bestimmten Label ändern kann, benötigt er die entsprechenden Berechtigungsstufen:

    • Drive-Element: EDITOR
    • Label: APPLIER

  • Lesen: Damit ein Nutzer die Metadaten von Drive-Elementen lesen oder nach ihnen suchen kann, die mit einem bestimmten Label verknüpft sind, benötigt er die entsprechenden Berechtigungsstufen:

    • Drive-Element: READER
    • Label: READER
Freigegeben

Nutzer, die keine Administratoren sind, können freigegebene Labels erstellen, die andere auf Drive-Elemente anwenden können. Teams können eigene Labels für die Verwendung innerhalb des Teams erstellen und organisieren, ohne dass ein Administrator erforderlich ist.

Labeltaxonomie

Die derzeit konfigurierten Labelfelder, die Nutzer auf Drive-Dateien anwenden können. Auch als Labelschema bezeichnet.

Beispiele für Labeltaxonomien:

  • Empfindlichkeit: Rot, Orange, Gelb, Grün
  • Status: Nicht gestartet, Entwurf, Wird geprüft, Abgeschlossen
  • Inhaltstyp: Vertrag, Designdokument, Mockup
  • Abteilung: Marketing, Finanzen, Personalwesen, Vertrieb
Labellebenszyklus

Labels durchlaufen einen Lebenszyklus, in dem sie erstellt, veröffentlicht, aktualisiert usw. werden. Wenn ein Label den Lebenszyklus durchläuft, wird seine Labelversion erhöht. Weitere Informationen finden Sie unter Labellebenszyklus.

Labelüberarbeitung

Eine Instanz des Labels. Jedes Mal, wenn ein Label erstellt, aktualisiert, veröffentlicht oder eingestellt wird, wird die Labelversion erhöht.

Entwurfsüberarbeitung
Die Versionsnummer der aktuellen Entwurfsversion des Labels. Sie können ein Label mehrmals aktualisieren, wobei die Versionsnummer des Entwurfs jedes Mal erhöht wird, ohne dass sich dies auf die veröffentlichte Version auswirkt. Mit der Möglichkeit, Labels als Entwurf zu speichern, können Sie Labelaktualisierungen vor der Veröffentlichung testen.
Veröffentlichte Version
Die Revisionsnummer der veröffentlichten Version eines Labels. Das veröffentlichte Label ist die Instanz des Labels, die derzeit für Nutzer verfügbar ist.