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}
oderlabels/{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 dazubadgeConfig
über dieProperties
vonChoice
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).
|
|
- 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
- Drive-Element:
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
- Drive-Element:
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.
Weitere Informationen
Um mehr über die Entwicklung mit Google Workspace APIs zu erfahren, einschließlich der Handhabung von finden Sie unter Erste Schritte als Google Workspace Entwickler.
Um zu erfahren, wie Sie eine einfache Labels API-Anwendung konfigurieren und ausführen, versuchen Sie Folgendes: Python-Kurzanleitung