Method: revisions.list

Отображает список версий файла. Дополнительную информацию см. в разделе «Управление версиями файлов» .

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

HTTP-запрос

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

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

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

Параметры
fileId

string

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

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

Параметры
pageSize

integer

Максимальное количество возвращаемых правок. Сервис может вернуть меньшее количество правок.

Если не указано иное, будет возвращено не более 200 исправлений.

Максимальное значение — 1000; значения выше 1000 будут принудительно уменьшены до 1000.

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

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