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 .