Введение в API активности Google Диска

API активности Google Drive состоит из ресурса DriveActivity , который представляет изменения, внесенные в объекты на Google Диске пользователя, и метода activity.query , который позволяет извлекать информацию об этих изменениях.

Запрос

Ваше приложение запрашивает данные об активности пользователя с помощью метода activity.query . Вы можете запросить активность как для конкретного элемента Диска, так и для всех данных, содержащихся в папке Диска. Для конкретного запроса вы можете ограничить ответ такими ограничениями , как временной диапазон или тип действия, а также включить консолидацию активности в ответе. Подробнее см. в разделе Выполнение запросов в API активности Диска .

Ответ

Ответ на запрос представляет собой список действий, соответствующих заданным параметрам, где ресурс DriveActivity представляет каждое действие:

Объяснение активности диска.

Ресурс DriveActivity представляет собой коллекцию объектов Action , каждый из которых самодостаточен, как событие . Action включает ActionDetail (например, Create или Edit ), Actor (например, User или Administrator ), Target (например, DriveItem или Drive ), а также Timestamp или TimeRange .

Ресурс DriveActivity также содержит сводную информацию, например, каждого Actor и Target из всех действий, унифицированную метку Timestamp или TimeRange , а также наиболее важные или репрезентативные ActionDetail для Action .

Дополнительную информацию см. в модели данных API Drive Activity .

Видимость истории активности

При использовании этого API некоторые действия на Диске могут не отражаться в отчётах. Сообщает ли API Drive Activity об изменении объекта, зависит от того, видно ли это изменение или информация об этом изменении аутентифицированному пользователю в вашем приложении.

Видимость зависит от разрешений, установленных для объекта. Существует несколько сценариев предоставления общего доступа к файлам и папкам на Диске:

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

Начать

Чтобы максимально эффективно использовать API Drive Activity, сначала интегрируйте своё приложение с API Google Drive . Чтобы начать работу с API Drive Activity, узнайте, как создать проект и авторизовать запросы . Или сразу приступайте к изучению действий в справочнике по API .