Method: files.listLabels

Wyświetla etykiety pliku. Więcej informacji znajdziesz w artykule Wyświetlanie etykiet na pliku.

Żądanie HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/listLabels

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Identyfikator pliku.

Parametry zapytania

Parametry
maxResults

integer

Maksymalna liczba etykiet do zwrócenia na stronie. Jeśli nie jest ustawiony, przyjmuje się domyślnie wartość 100.
pageToken

string

Token umożliwiający kontynuowanie poprzedniego żądania listy na następnej stronie. Powinna być ustawiona na wartość nextPageToken z poprzedniej odpowiedzi.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista etykiet zastosowanych do pliku.

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

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

object (Label)

Lista etykiet.
nextPageToken

string

Token strony z etykietami. To pole będzie nieobecne, jeśli osiągnięto koniec listy. Jeśli token zostanie odrzucony z jakiegokolwiek powodu, należy go odrzucić, a stronicowanie należy rozpocząć od pierwszej strony wyników. Token strony jest zwykle ważny przez kilka godzin. Jeśli jednak dodasz lub usuniesz nowe produkty, oczekiwane wyniki mogą się różnić.
kind

string

Zawsze jest to "drive#labelList".

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

Niektóre zakresy są ograniczone i wymagają oceny bezpieczeństwa, aby aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.