Method: labels.get

Ein Label anhand seines Ressourcennamens abrufen Weitere Informationen finden Sie unter Nach Labels suchen.

Der Ressourcenname kann Folgendes sein:

  • labels/{id} – siehe labels/{id}@latest
  • labels/{id}@latest: Ruft die letzte Überarbeitung des Labels ab.
  • labels/{id}@published: Ruft die aktuell veröffentlichte Überarbeitung des Labels ab.
  • labels/{id}@{revisionId}: Ruft das Label mit der angegebenen Überarbeitungs-ID ab.

HTTP-Anfrage

GET https://drivelabels.googleapis.com/v2/{name=labels/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Ressourcenname des Labels.

Mögliche Werte:

  • labels/{id} (entspricht „labels/{id}@latest“)
  • labels/{id}@latest
  • labels/{id}@published
  • labels/{id}@{revisionId}

Abfrageparameter

Parameter
useAdminAccess

boolean

Legen Sie true fest, um die Administratoranmeldedaten des Nutzers zu verwenden. Der Server prüft, ob der Nutzer Administrator für das Label ist, bevor er den Zugriff zulässt.
languageCode

string

Der BCP-47-Sprachcode, der zum Auswerten lokalisierter Feldlabels verwendet werden soll. Wenn nichts angegeben ist, werden Werte in der standardmäßig konfigurierten Sprache verwendet.
view

enum (LabelView)

Wenn angegeben, werden nur bestimmte Felder der angegebenen Ansicht zurückgegeben.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Label.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.labels.readonly
  • https://www.googleapis.com/auth/drive.admin.labels
  • https://www.googleapis.com/auth/drive.admin.labels.readonly

Weitere Informationen finden Sie im Autorisierungsleitfaden.