Method: revisions.list

Wyświetla listę wersji pliku. Więcej informacji znajdziesz w artykule Zarządzanie wersjami plików.

Ważne: lista wersji zwracana przez tę metodę może być niepełna w przypadku plików z długą historią wersji, 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 wersji widoczna w interfejsie edytora Workspace może być bardziej kompletna niż lista zwracana przez interfejs API.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Identyfikator pliku.

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba zwracanych wersji. Usługa może zwrócić mniej niż ta wartość.

Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 200 wersji.

Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
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

Lista wersji pliku.

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

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

object (Revision)

Lista wersji. 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 wersji. Będzie on nieobecny, 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. 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

Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "drive#revisionList".

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.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 aplikacji. Więcej informacji znajdziesz w przewodniku po autoryzacji.