Drive Labels API – Übersicht

Labels sind Metadaten, die Sie definieren, damit Nutzer Dateien in Google Drive leichter organisieren, finden und Richtlinien darauf anwenden können. Die Drive Labels API ist eine RESTful API, die Geschäftsprozesse unterstützt, indem Metadaten an Ihre Drive-Dateien angehängt werden. Diese API wird häufig in folgenden Fällen verwendet:

  • Inhalte gemäß einer Strategie zur Informationssteuerung klassifizieren: Erstellen Sie ein Label, um sensible Inhalte oder Daten zu identifizieren, die eine besondere Behandlung erfordern. Sie können beispielsweise ein Badge-Label (ein Label mit farbcodierten Optionswerten) mit dem Titel „Empfindlichkeit“ und den Werten „Streng geheim“, „Vertraulich“ und „Öffentlich“ erstellen.

  • Richtlinien auf Elemente in Drive anwenden: Erstellen Sie Labels, um Drive-Inhalte während ihres gesamten Lebenszyklus zu verwalten und sicherzustellen, dass sie den Praktiken Ihrer Organisation zur Dokumentationspflicht entsprechen. Verwenden Sie beispielsweise Labels, um eine Richtlinie für Datenverlust (Data Loss Prevention, DLP) zu verwalten, gemäß der Dateien, deren Label "Vertraulichkeit" auf "Streng geheim" gesetzt ist, nicht auf einen Computer heruntergeladen werden können.

  • Dateien auswählen und suchen: Erstellen Sie Labels, um die Sichtbarkeit der Inhalte Ihres Unternehmens zu verbessern. Damit ermöglichen Sie Personen in Ihrer Organisation, Elemente anhand von Labels und ihren Feldern zu finden. Beispielsweise könnte ein Nutzer in Ihrer Organisation die Suchoptionen in Google Drive verwenden, um alle Verträge zu finden, die bis zu einem bestimmten Datum unterzeichnet werden müssen.

Im Folgenden finden Sie eine Liste häufig verwendeter Begriffe in der Drive Labels API:

Beschriftung

Strukturierte Metadaten in einer Drive-Datei. Drive-Nutzer können Labels zuweisen und Labelfeldwerte für Dateien festlegen. Labels bestehen aus folgenden Komponenten:

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 unter Labelüberarbeitung unten.
Label-ID
Eine global eindeutige Kennung für das Label. Die ID ist Teil des Labelnamens, ist aber im Gegensatz zum Namen zwischen den Überarbeitungen einheitlich.

Es gibt zwei Arten von Labels:

Badge-Label

Ein Label mit dem Feldtyp SelectionOptions, der Optionen enthält, die farblich codiert werden können, um die Wichtigkeit anzuzeigen. Legen Sie dazu badgeConfig über den Properties eines Choice fest.

Drive zeigt für jede Datei die Farbe der ausgewählten Option an, damit Nutzer den Status, die Klassifizierung usw. der Datei leicht erkennen können. Die Option „Streng geheim“ für das Badge-Label „Vertraulichkeit“ kann beispielsweise rot angezeigt werden. Sie können jeweils nur ein Badge-Label haben.

Standard label

Ein Label, das null oder mehr Feldtypen enthält. Ein Standardlabel kann einen Labeltitel wie „Projekt Moonshot“ haben und alle Dateien angeben, die sich auf das Projekt beziehen. Ein Standardlabel kann auch mehrere strukturierte Felder haben. Beispielsweise könnte ein Label mit dem Titel "Vertrag" 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. Badge-Label
Standard-Label-Diagramm
Abbildung 2: Standard label
Feld

Eine einzelne eingegebene, einstellbare Komponente eines Labels. Einem Label können null oder mehr Felder zugeordnet 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 Drive-Elemente als auch auf die verfügbaren Suchanfrageoptionen aus.
Auswahl

Eine von mehreren Optionen, die ein Nutzer innerhalb eines SelectionOptions-Felds auswählen kann.

Labeltyp

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

Administrator

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

Administratoren können Administratorlabels für jeden Nutzer freigeben, um ihm die Berechtigung zu gewähren, sie anzusehen und auf Drive-Elemente anzuwenden. Zum Ändern oder Lesen von Labelwerten für Drive-Elemente sind die folgenden Berechtigungen erforderlich:

  • Ändern: Damit ein Nutzer die Metadaten eines Drive-Elements für ein bestimmtes Label ändern kann, muss er die entsprechenden Berechtigungsstufen haben:

    • Drive-Element: EDITOR
    • Label: APPLIER

  • Lesen: Damit ein Nutzer die Metadaten eines Drive-Elements im Zusammenhang mit einem bestimmten Label lesen oder suchen kann, muss er die entsprechenden Berechtigungsstufen haben:

    • Drive-Element: READER
    • Label: READER
Freigegeben

Nutzer, die keine Administratoren sind, können gemeinsame Labels erstellen, die andere auf Drive-Elemente anwenden können. Teams können ihre eigenen Labels zur Verwendung innerhalb des Teams erstellen und organisieren, ohne dass ein Administrator dafür sorgen muss.

Label-Taxonomie

Die derzeit konfigurierten Labelfelder, die Nutzern für die Anwendung auf Drive-Dateien zur Verfügung stehen. Wird auch als Labelschema bezeichnet.

Beispiele für Labeltaxonomien:

  • Empfindlichkeit: Rot, Orange, Gelb, Grün
  • Status: noch nicht begonnen, Entwurf, Überprüfung, Fertig
  • Inhaltstyp: Vertrag, Design-Dokument, Mockup
  • Abteilung – Marketing, Finanzen, Personalabteilung, Vertrieb
Labellebenszyklus

Labels durchlaufen einen Lebenszyklus, in dem sie unter anderem erstellt, veröffentlicht und aktualisiert werden. Während ein Label den Lebenszyklus durchläuft, wird seine Labelüberarbeitung erhöht. Weitere Informationen finden Sie unter Labellebenszyklus.

Labelversion

Eine Instanz des Labels. Jedes Mal, wenn ein Label erstellt, aktualisiert, veröffentlicht oder verworfen wird, erhöht sich die Labelüberarbeitung.

Überarbeitungsentwurf
Die Versionsnummer der aktuellen Entwurfsinstanz des Labels. Sie können mehrere Aktualisierungen an einem Label vornehmen, die jeweils die Nummer der Entwurfsversion erhöhen, ohne dass sich dies auf die veröffentlichte Version auswirkt. Durch die Möglichkeit, Labelentwürfe zu verwenden, können Sie Labelaktualisierungen vor der Veröffentlichung testen.
Veröffentlichte Überarbeitung
Die Versionsnummer der veröffentlichten Version eines Labels. Das veröffentlichte Label ist die Instanz des Labels, das derzeit Nutzern zur Verfügung steht.