Method: labels.get

Rufen Sie ein Label anhand seines Ressourcennamens ab. Ressourcennamen können wie folgt lauten:

  • labels/{id} – Siehe labels/{id}@latest
  • labels/{id}@latest: Ruft die neueste Version des Labels ab.
  • labels/{id}@published: Ruft die aktuell veröffentlichte Version des Labels ab.
  • labels/{id}@{revisionId}: Ruft das Label unter 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.

Kann Folgendes sein:

  • 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 überprüft, ob der Nutzer ein Administrator für das Label ist, bevor er den Zugriff gewährt.
languageCode

string

Der BCP-47-Sprachcode für die Auswertung lokalisierter Feldlabels. Wenn keine Angabe erfolgt, werden Werte in der standardmäßig konfigurierten Sprache verwendet.
view

enum (LabelView)

Wenn angegeben, werden nur bestimmte Felder zurückgegeben, die zur angegebenen Ansicht gehören.

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 Leitfaden zur Autorisierung.