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 aufgenommen werden sollen.

  • Bei true werden nur die aktuell veröffentlichten Labelversionen zurückgegeben. Deaktivierte Labels sind enthalten. Die zurückgegebenen Labelressourcennamen verweisen auf die veröffentlichte Version (labels/{id}/{revisionId}).
  • Bei false werden die aktuellen Labelversionen 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 diese Listenanfrage beschränkt werden soll. Beispiel: „customers/abcd1234“. Wenn die Richtlinie nicht konfiguriert ist, werden alle Labels innerhalb des aktuellen Kunden zurückgegeben.
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.
pageSize

integer

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

string

Das Token der Seite, die zurückgegeben werden soll.
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 Mindestrolle, die ein Nutzer für ein Label haben muss. Die Standardeinstellung ist READER.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort für das 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.