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

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 .