Method: revisions.list

Список версий файла. Подробнее см. в разделе Управление версиями файла .

Важно: Список ревизий, возвращаемый этим методом, может быть неполным для файлов с большой историей изменений, включая часто редактируемые документы Google Docs, таблицы и презентации. Более старые ревизии могут быть пропущены в ответе, то есть первая возвращённая ревизия может быть не самой старой из существующих. История ревизий, отображаемая в пользовательском интерфейсе редактора рабочей области, может быть более полной, чем список, возвращаемый API.

HTTP-запрос

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

URL использует синтаксис перекодировки gRPC .

Параметры пути

Параметры
fileId

string

Идентификатор файла.

Параметры запроса

Параметры
pageSize

integer

Максимальное количество возвращаемых изменений на страницу.

pageToken

string

Токен для продолжения предыдущего запроса списка на следующей странице. Значение должно быть равно значению «nextPageToken» из предыдущего ответа.

Текст запроса

Тело запроса должно быть пустым.

Тело ответа

Список версий файла.

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "revisions": [
    {
      object (Revision)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Поля
revisions[]

object ( Revision )

Список ревизий. Если nextPageToken заполнен, этот список может быть неполным, и необходимо загрузить дополнительную страницу результатов.

nextPageToken

string

Токен страницы для следующей страницы ревизий. Он будет отсутствовать, если достигнут конец списка ревизий. Если токен по какой-либо причине отклонён, его следует удалить, а пагинацию следует перезапустить с первой страницы результатов. Токен страницы обычно действителен в течение нескольких часов. Однако при добавлении или удалении новых элементов ожидаемые результаты могут отличаться.

kind

string

Определяет тип ресурса. Значение: фиксированная строка "drive#revisionList" .

Области авторизации

Требуется одна из следующих областей 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

Некоторые области действия ограничены, и для их использования вашему приложению требуется оценка безопасности. Подробнее см. в руководстве по авторизации .