Method: labels.list

Labels auflisten.

HTTP-Anfrage

GET https://drivelabels.googleapis.com/v2/labels

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
publishedOnly

boolean

Gibt an, ob nur veröffentlichte Labels in die Ergebnisse einbezogen werden sollen.

  • Bei true werden nur die aktuell veröffentlichten Labelüberarbeitungen zurückgegeben. Deaktivierte Labels sind enthalten. Die zurückgegebenen Labelressourcennamen verweisen auf die veröffentlichte Version (labels/{id}/{revisionId}).
  • Bei false werden die aktuellen Labelüberarbeitungen zurückgegeben, die möglicherweise nicht veröffentlicht werden. Die zurückgegebenen Labelressourcennamen verweisen nicht auf eine bestimmte Überarbeitung (labels/{id}).
customer

string

Der Kunde, auf den die Listenanfrage beschränkt werden soll. Beispiel: „customers/abcd1234“. Wenn die Richtlinie nicht konfiguriert ist, werden alle Labels des aktuellen Kunden zurückgegeben.
languageCode

string

Der BCP-47-Sprachcode zur Auswertung von lokalisierten Feldlabels. Wenn keine Angabe erfolgt, werden Werte in der konfigurierten Standardsprache verwendet.
pageSize

integer

Maximale Anzahl von Labels, die pro Seite zurückgegeben werden sollen. Der Standardwert ist 50. Max: 200.
pageToken

string

Das Token der zurückzugebenden Seite.
view

enum (LabelView)

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

Union-Parameter access.

Für access ist nur einer der folgenden Werte zulässig:
useAdminAccess

boolean

Legen Sie true fest, um die Administratoranmeldedaten des Nutzers zu verwenden. Dadurch werden alle Labels innerhalb des Kunden zurückgegeben.
minimumRole

enum (LabelRole)

Gibt die Zugriffsebene an, die der Nutzer auf die zurückgegebenen Labels haben muss. Die minimale Rolle, die ein Nutzer für ein Label haben muss. Die Standardeinstellung ist READER.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort zum Auflisten von Labels.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
Felder
labels[]

object (Label)

Labels:
nextPageToken

string

Das Token der nächsten Seite in der Antwort.

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.