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