Method: revisions.list

Wyświetla listę wersji pliku.

Ważne: lista zmian zwracana przez tę metodę może być niekompletna w przypadku plików z długą historią zmian, w tym często edytowanych Dokumentów, Arkuszy i Prezentacji Google. Starsze wersje mogą zostać pominięte w odpowiedzi, co oznacza, że pierwsza zwrócona wersja może nie być najstarszą istniejącą wersją. Historia zmian widoczna w interfejsie edytora Workspace może być bardziej kompletna niż lista zwracana przez interfejs API.

Żądanie HTTP

GET https://www.googleapis.com/drive/v2/files/{fileId}/revisions

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Identyfikator pliku.

Parametry zapytania

Parametry
maxResults

integer

Maksymalna liczba wersji do zwrócenia.
pageToken

string

Token strony dla wersji. Aby uzyskać następną stronę wyników, ustaw ten parametr na wartość „nextPageToken” z poprzedniej odpowiedzi.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista wersji pliku.

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

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

object (Revision)

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

string

Token strony dla następnej strony wersji. To pole nie będzie występować, jeśli osiągnięto koniec listy wersji. Jeśli token zostanie odrzucony z jakiegokolwiek powodu, należy go odrzucić i ponownie rozpocząć paginację od pierwszej strony wyników.
kind

string

Zawsze jest to drive#revisionList.
etag

string

ETag listy.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/docs
  • 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.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.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.