Drive Labels API – Übersicht

Labels sind Metadaten, die Sie definieren, damit Nutzer Dateien in Google Drive leichter organisieren, finden und Richtlinien auf sie anwenden können. Die Drive Labels API ist eine RESTful API, mit der Geschäftsprozesse durch das Anhängen von Metadaten an Ihre Drive-Dateien unterstützt werden. Häufige Anwendungsbereiche für diese API:

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

  • Richtlinien auf Elemente in Google Drive anwenden: Erstellen Sie Labels, um Drive-Inhalte während des gesamten Lebenszyklus zu verwalten und sicherzustellen, dass die Dokumentationspraktiken Ihrer Organisation eingehalten werden. Beispielsweise können Sie Labels verwenden, um eine Richtlinie für Datenverlust (Data Loss Prevention, DLP) zu verwalten, nach der Dateien mit dem Label „Vertraulichkeit“ auf „Streng geheim“ nicht auf einen Computer heruntergeladen werden können.

  • Dateien auswählen und suchen: Erstellen Sie Labels, um die Sichtbarkeit Ihrer Unternehmensinhalte zu verbessern, indem Sie Personen in Ihrer Organisation ermöglichen, Elemente anhand von Labels und ihren Feldern zu finden. Beispielsweise könnte eine Person in Ihrer Organisation die Drive-Suchoptionen 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 Werte für Labelfelder festlegen. Labels bestehen aus:

Label name
Der Ressourcenname des Labels. Die Label-ID ist Teil des Labelnamens. Je nach Anfrage hat der Name entweder labels/{id} oder labels/{id}@{revisionId}. Weitere Informationen finden Sie unten im Abschnitt Labelüberarbeitung.
Label-ID
Eine global eindeutige Kennung für das Label. Die ID ist ein Teil des Labelnamens, ist aber im Gegensatz zum Namen unter den Überarbeitungen einheitlich.

Es gibt zwei Arten von Labels:

Badge-Label

Ein Label mit dem Feldtyp SelectionOptions, das choices enthält, das farblich codiert werden kann, um die Wichtigkeit anzugeben. Dazu wird badgeConfig über den Properties einer 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 klar erkennen können. So kann beispielsweise die Option „Streng geheim“ für das Badge-Label „Vertraulichkeit“ rot angezeigt werden. Sie können jeweils nur ein Badge-Label verwenden.

Standard label

Ein Label, das null oder mehr Feldtypen enthält. Ein Standardlabel kann einen Labeltitel wie „Project Moonshot“ haben und alle Dateien angeben, die sich auf das Projekt beziehen. Ein Standardlabel kann auch mehrere strukturierte Felder haben. Ein Label mit dem Titel "Vertrag" könnte beispielsweise die Felder "Unternehmen", "Fälligkeitsdatum", "Status" und "Unterzeichner" enthalten. Jedes Feld hat einen bestimmten Typ (Text, Datum, Auswahl oder Nutzer).

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

Eine einzelne typisierte, festlegbare Komponente eines Labels. Einem Label können keine oder mehrere 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 Optionen für Suchanfragen aus.
Auswahl

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:

Admin

Zum Erstellen und Bearbeiten von Labels mit Administratorberechtigungen müssen Sie ein Kontoadministrator mit der Berechtigung Labels verwalten sein.

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

  • Ändern: Damit ein Nutzer die Metadaten eines Drive-Elements ändern kann, die sich auf ein bestimmtes Label beziehen, muss er die entsprechenden Berechtigungsstufen haben:

    • Drive-Element: EDITOR
    • Label: APPLIER

  • Lesen: Damit ein Nutzer die Drive-Elementmetadaten eines bestimmten Labels 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 eigene Labels zur Verwendung im Team erstellen und organisieren, ohne dass ein Administrator erforderlich ist.

Label-Taxonomie

Die aktuell 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“, „Wird geprüft“, „Fertig“
  • Inhaltstyp: Vertrag, Designdokument, Modell
  • Abteilung – Marketing, Finanzen, Personalwesen, Vertrieb
Label-Lebenszyklus

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

Labelüberarbeitung

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, bei denen jeweils die Nummer der Entwurfsversion erhöht wird, ohne dass sich dies auf die veröffentlichte Überarbeitung auswirkt. Mit der Möglichkeit, Labelentwürfe zu erstellen, 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, die derzeit für Nutzer verfügbar ist.