Method: files.listLabels

Wyświetla listę etykiet 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 stronę. Jeśli zasada nie jest skonfigurowana, domyślnie przyjmuje się wartość 100.
pageToken

string

Token kontynuujący poprzednie żądanie listy na następnej stronie. Należy ustawić wartość „nextPageToken” niż w przypadku 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 dla następnej strony etykiet. To pole pozostanie puste, jeśli zostanie osiągnięty koniec listy. Jeśli token zostanie z jakiegokolwiek powodu odrzucony, należy go unieważnić, a podział na strony powinien rozpocząć się od nowa na pierwszej stronie wyników. Token strony jest zwykle ważny przez kilka godzin. Jeśli jednak dodasz lub usuniesz nowe elementy, oczekiwane wyniki mogą się różnić.
kind

string

To zawsze jest drive#labelList

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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. Aby można było z nich korzystać, aplikacja musi przeprowadzić ocenę zabezpieczeń. Więcej informacji znajdziesz w przewodniku na temat autoryzacji.