API активности Google Диска состоит из ресурса DriveActivity , который представляет изменения, внесенные в объекты на Google Диске пользователя, и метода activity.query , который позволяет получать информацию об этих изменениях.
Запрос
Ваше приложение запрашивает данные об активности пользователя с помощью метода activity.query . Вы можете запросить активность либо для определенного элемента Диска, либо для всего, что содержится в папке Диска. Для данного запроса вы можете ограничить ответ такими ограничениями , как диапазон времени или тип действия, а также выбрать консолидацию действия в ответе. Дополнительную информацию см. в разделе «Выполнение запросов в Drive Activity API» .
Ответ
Ответом на запрос является список действий, соответствующих заданным параметрам, где ресурс 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 некоторые действия на Диске могут не сообщаться. Сообщает ли API активности диска о данном изменении объекта, зависит от того, видно ли это изменение или информация об изменении аутентифицированному пользователю в вашем приложении.
Видимость зависит от разрешений, установленных для объекта. Существует несколько сценариев, когда файлы и папки делятся на Диске:
- Если автор поделился документом, история действий с документом видна не только создателю, но и прошедшим проверку подлинности пользователям, которым был предоставлен общий доступ.
- Если к документу был предоставлен доступ пользователю, а затем он стал личным, аутентифицированный пользователь может видеть всю историю действий, пока у него был доступ, и что разрешения теперь ограничены.
- Если документ никогда не был доступен пользователю, пользователь не сможет просмотреть историю действий.
Начать
Чтобы максимально эффективно использовать API активности диска, сначала интегрируйте свое приложение с API Google Диска . Чтобы начать работу с Drive Activity API, узнайте, как создать проект и авторизовать запросы . Или сразу же погрузитесь и прочитайте о действиях в справочнике по API .