API активности Google Диска состоит из ресурса DriveActivity
, который представляет изменения, внесенные в объекты на пользовательском Диске Google, и метода activity.query
, который позволяет получать информацию об этих изменениях.
Запрос
Ваше приложение запрашивает данные о действиях пользователя с помощью метода activity.query
. Вы можете запросить активность либо для определенного элемента на Диске, либо для всего, что находится в папке на Диске. Для данного запроса вы можете ограничить ответ ограничениями , такими как диапазон времени или тип действия, и вы можете выбрать консолидацию действий в ответе. Дополнительные сведения см. в статье Отправка запросов в API Drive Activity .
Ответ
Ответ на запрос представляет собой список действий, соответствующих заданным параметрам, где ресурс DriveActivity
представляет каждое действие:
Ресурс DriveActivity
— это набор объектов Action
, каждый из которых автономен, как событие . Action
включает в себя ActionDetail
(например, Create
или Edit
), Actor
(например, User
или Administrator
), Target
(например, DriveItem
или Drive
) и либо Timestamp
, либо TimeRange
.
Ресурс DriveActivity
также содержит сводную информацию, такую как каждый Actor
и Target
из всех действий, унифицированную Timestamp
или TimeRange
, а также наиболее важную или репрезентативную ActionDetail
Action
.
Дополнительные сведения см. в модели данных Drive Activity API .
Видимость истории активности
О некоторых действиях на Диске может не сообщаться при использовании этого API. Сообщает ли Drive Activity API о данном изменении объекта, зависит от того, видно ли это изменение или информацию об изменении аутентифицированному пользователю в вашем приложении.
Видимость основана на разрешениях, установленных для объекта. Существует несколько сценариев, когда файлы и папки являются общими на Диске:
- Если автор предоставляет общий доступ к документу, история действий с документом видна не только создателю, но и аутентифицированным пользователям, которым он был предоставлен.
- Если пользователю был предоставлен общий доступ к документу, а затем он стал личным, аутентифицированный пользователь может видеть всю историю действий, пока у него был доступ, и то, что разрешения теперь ограничены.
- Если пользователю никогда не предоставлялся доступ к документу, он не может просматривать историю действий.
Начать
Чтобы получить максимальную отдачу от Drive Activity API, сначала интегрируйте свое приложение с Google Drive API . Чтобы начать работу с Drive Activity API, узнайте, как создать проект и авторизовать запросы . Или сразу погрузитесь и прочитайте о действиях в справочнике по API .