Drive Labels API – Übersicht

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

  • Inhalte anhand einer Informationssteuerungsstrategie klassifizieren: Erstellen Sie ein , um sensible Inhalte oder Daten zu kennzeichnen, die eine besondere Behandlung erfordern. Sie können beispielsweise ein Badge-Label (ein Label mit farbcodierten mit dem Titel „Empfindlichkeit“ mit den Werten von „Streng geheim“ „Vertraulich“ und „Öffentlich“.

  • Richtlinien auf Elemente in Drive anwenden: Labels zum Verwalten erstellen Sorgen Sie dafür, dass Inhalte während des gesamten Lebenszyklus eingehalten und eingehalten werden. die Dokumentationspflicht Ihrer Organisation. Verwenden Sie Labels beispielsweise, um eine Richtlinie für den Datenverlust (Data Loss Prevention, DLP) verwalten, durch die Dateien mit der Labelsatz zu „Streng geheim“ können nicht auf einen Computer heruntergeladen werden.

  • Dateien auswählen und suchen: Erstellen Sie Labels, um die Sichtbarkeit Ihrer Unternehmensinhalte anzeigen, indem Sie es Personen in Ihrer Organisation ermöglichen, Elemente basierend auf Labels und ihre Felder. Beispielsweise könnte eine Person in Ihrer Organisation Drive-Suchoptionen, um alle Verträge zu finden, die noch nicht unterzeichnet werden müssen bis zu einem bestimmten Datum.

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 festlegen für -Dateien. Labels bestehen aus folgenden Komponenten:

Label name
Der Ressourcenname des Labels. Die Label-ID ist Bestandteil des Label name. Je nach Anfrage hat der Name das folgende Format: labels/{id} oder labels/{id}@{revisionId}. Weitere Informationen finden Sie unter Labelversion unten.
Label-ID
Eine global eindeutige Kennung für das Label. Die ID ist Teil des Labelname, aber im Gegensatz zum Namen ist er zwischen den Überarbeitungen einheitlich.

Es gibt zwei Arten von Labels:

Badge-Label

Ein Label mit einem SelectionOptions Feldtyp mit Auswahlmöglichkeiten, die farblich gekennzeichnet werden können, Bedeutung. Legen Sie dazu badgeConfig über die Properties von Choice

Google Drive zeigt für jede Datei die Farbe der ausgewählten Option an, Status, Klassifizierung usw. der Datei verstehen. Zum Beispiel der „Streng geheim“ für die Einstellung „Empfindlichkeit“ Badge-Label möglicherweise rot. 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 haben, z. B. "Projekt Moonshot", und geben Sie alle Dateien an, die mit dem Projekt zusammenhängen. Ein Standardlabel kann auch mehrere strukturierten Feldern. Beispiel: Ein Label mit dem Titel „Vertrag“ könnten die Felder für "Company", „Fälligkeitsdatum“ „Status“, und „Unterzeichner“. Jedes Feld hat einen bestimmten Typ (Text, Datum, Auswahl oder Nutzer).

<ph type="x-smartling-placeholder">
</ph> Diagramm mit Badge-Label.
Abbildung 1: Badge-Label
 <ph type="x-smartling-placeholder">
</ph> Standard-Label-Diagramm
Abbildung 2: Standard label
Feld

Eine einzelne eingegebene, einstellbare Komponente eines Labels. Ein Label kann null oder weitere Felder verknüpft sind.

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 können Sie die Nutzer- und Auswahlfelder mit mehreren Werte. Der gewählte Typ wirkt sich sowohl auf die gültigen Werte für Drive-Elemente und die verfügbaren Suchanfragenoptionen
Auswahl

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

Labeltyp

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

Administrator

Sie müssen ein Konto sein, um Labels des Administrators zu erstellen und zu bearbeiten Administrator mit der Labels verwalten privilegiert.

Administratoren können Administratorlabels für jeden Nutzer freigeben, um diesem Nutzer Folgendes zu gewähren: die Möglichkeit, sie anzusehen und auf Drive-Elemente anzuwenden. Ändern oder Lesen Für Labelwerte für Drive-Elemente sind die folgenden Berechtigungen erforderlich:

  • Ändern: Damit können Nutzer die Metadaten eines Drive-Elements für eine muss der Nutzer die entsprechenden Berechtigungsstufen haben:

    • Drive-Element: EDITOR
    • Label: APPLIER

  • Lesen: Nutzer können die Metadaten des Drive-Elements lesen oder danach suchen. die mit einem bestimmten Label zusammenhängen, Berechtigungsstufen:

    • Drive-Element: READER
    • Label: READER
Freigegeben

Nutzer, die keine Administratoren sind, können gemeinsame Labels erstellen, die andere anwenden können Drive-Elementen hinzufügen. Teams können eigene Labels erstellen und organisieren ohne eine Administratorin oder einen Administrator.

Label-Taxonomie

Die aktuell konfigurierten Labelfelder, die Nutzern für die Anwendung zur Verfügung stehen Drive-Dateien. 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 erstellt, veröffentlicht, aktualisiert und so weiter. Während ein Label den Lebenszyklus durchläuft, ist 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 wird die Labelüberarbeitung erhöht.

Überarbeitungsentwurf
Die Versionsnummer der aktuellen Entwurfsinstanz des Labels. Sie können Mehrere Aktualisierungen an einem Label vornehmen, wobei jede den Entwurf der Überarbeitung erhöht ohne Auswirkungen auf die veröffentlichte Überarbeitung. Die Fähigkeit, Mit Labelentwürfen können Sie Labelaktualisierungen vor der Veröffentlichung testen.
Veröffentlichte Überarbeitung
Die Versionsnummer der veröffentlichten Version eines Labels. Die veröffentlichte label ist die Instanz des Labels, die derzeit für Nutzer verfügbar ist.