Method: changes.list

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

HTTP-запрос

GET https://www.googleapis.com/drive/v3/changes

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

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

Параметры
driveId

string

Общий диск, с которого будут возвращаться изменения. Если указано, идентификаторы изменений будут соответствовать общему диску; используйте объединенный идентификатор диска и идентификатор изменения в качестве идентификатора.

includeCorpusRemovals

boolean

Следует ли включать изменения в ресурс файла, если файл по-прежнему доступен пользователю на момент запроса, даже если файл был удален из списка изменений и для этого файла больше не будет записей об изменениях?

includeItemsFromAllDrives

boolean

Следует ли включать в результаты как элементы "Мой диск", так и элементы общего диска?

includeRemoved

boolean

Следует ли включать изменения, указывающие на то, что элементы были удалены из списка изменений, например, путем удаления или потери доступа.

includeTeamDriveItems
(deprecated)

boolean

Устарело: используйте includeItemsFromAllDrives вместо этого.

pageSize

integer

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

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

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

pageToken

string

Токен для продолжения предыдущего запроса списка на следующей странице. Его следует установить равным значению параметра 'nextPageToken' из предыдущего ответа или ответу метода getStartPageToken.

restrictToMyDrive

boolean

Ограничивать ли результаты изменениями внутри иерархии «Мой диск». В этом случае изменения файлов, например, находящихся в папке «Данные приложения» или общих файлов, не добавленных в «Мой диск», не будут учтены.

spaces

string

Разделенный запятыми список пространств для запроса в рамках корпуса. Поддерживаемые значения: 'drive' и 'appDataFolder'.

supportsAllDrives

boolean

Указывается, поддерживает ли запрашивающее приложение как раздел «Мои диски», так и общие диски.

supportsTeamDrives
(deprecated)

boolean

Устарело: используйте supportsAllDrives вместо этого.

teamDriveId
(deprecated)

string

Устарело: используйте driveId вместо него.

includePermissionsForView

string

Указывает, разрешения какого дополнительного представления следует включить в ответ. Поддерживается только разрешение для представления "published".

includeLabels

string

Список идентификаторов меток, разделенных запятыми, для включения в часть labelInfo ответа.

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

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

Ответный текст

Список изменений для пользователя.

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

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

object ( Change )

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

kind

string

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

nextPageToken

string

Токен страницы для перехода на следующую страницу изменений. Он будет отсутствовать, если список изменений завершен. Срок действия токена страницы не истекает.

newStartPageToken

string

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

Области полномочий

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

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