Method: approvals.list

Wyświetla listę zatwierdzeń pliku. Więcej informacji znajdziesz w artykule Zarządzanie zatwierdzeniami.

Domyślnie ta metoda zwraca minimalną odpowiedź, która może nie zawierać tablicy items. Aby pobrać szczegóły zatwierdzenia, musisz wyraźnie określić pola, które chcesz pobrać, za pomocą parametru zapytania fields. Aby zwrócić dokładnie te pola, których potrzebujesz, zapoznaj się z sekcją Zwracanie określonych pól.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Wymagane. Identyfikator pliku, którego dotyczy zatwierdzenie.

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba zatwierdzeń do zwrócenia. Jeśli nie jest ustawiona, zwracanych jest co najwyżej 100 zatwierdzeń.
pageToken

string

Token umożliwiający kontynuowanie poprzedniego żądania listy na następnej stronie. Należy ustawić wartość nextPageToken z poprzedniej odpowiedzi.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na żądanie listy zatwierdzeń.

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

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

string

Zawsze drive#approvalList
items[]

object (Approval)

Lista zatwierdzeń. Jeśli pole nextPageToken jest wypełnione, ta lista może być niepełna i należy pobrać dodatkową stronę wyników.
nextPageToken

string

Token strony dla następnej strony zatwierdzeń. Jest nieobecny, jeśli osiągnięto koniec listy zatwierdzeń. Jeśli token zostanie odrzucony z jakiegokolwiek powodu, należy go odrzucić, a paginację należy rozpocząć od pierwszej strony wyników.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • 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 aplikacji. Więcej informacji znajdziesz w przewodniku po autoryzacji.