Method: labels.list

Wyświetl etykiety.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
publishedOnly

boolean

Określa, czy w wynikach mają być uwzględniane tylko opublikowane etykiety.

  • Jeśli jest ustawiona wartość true, zwracane są tylko aktualnie opublikowane wersje etykiet. Uwzględniane są wyłączone etykiety. Zwrócone nazwy zasobów etykiet odnoszą się do opublikowanej wersji (labels/{id}/{revisionId}).
  • Kiedy false, zwracane są bieżące wersje etykiet, które mogą nie zostać opublikowane. Zwrócone nazwy zasobów etykiet nie odnoszą się do konkretnej wersji (labels/{id}).
customer

string

Klient, który ma określić zakres tej prośby o listę. Na przykład: „customers/abcd1234”. Jeśli nie jest skonfigurowana, zwraca wszystkie etykiety w ramach bieżącego klienta.
languageCode

string

Kod języka BCP-47 używany do oceny zlokalizowanych etykiet pól. Jeśli go nie określisz, używane będą wartości w domyślnym skonfigurowanym języku.
pageSize

integer

Maksymalna liczba etykiet do zwrócenia na stronę. Wartość domyślna: 50. Maks.: 200.
pageToken

string

Token strony do zwrócenia.
view

enum (LabelView)

Jeśli podasz te wartości, zwracane będą tylko niektóre pola należące do wskazanego widoku.

Parametr sumy funkcji access.

access może być tylko jedną z tych wartości:
useAdminAccess

boolean

Ustaw wartość true, aby korzystać z danych logowania administratora. Spowoduje to zwrócenie wszystkich etykiet klienta.
minimumRole

enum (LabelRole)

Określa poziom dostępu użytkownika do zwróconych etykiet. Minimalna rola, jaką użytkownik musi mieć w odniesieniu do etykiety. Domyślna wartość to READER.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź dotycząca etykiet listy.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
Pola
labels[]

object (Label)

Etykiety.
nextPageToken

string

Token następnej strony w odpowiedzi.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • 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

Więcej informacji znajdziesz w przewodniku po autoryzacji.