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

В этом документе представлен обзор API активности Google Диска.

API Drive Activity позволяет запрашивать информацию о недавних событиях. Вы можете получить подробную историю всех действий, включая подробную информацию о каждом событии. Это полезно для таких задач, как аудит, поскольку позволяет получать точные данные о действиях, включая информацию об ActionDetail , Actor и Target .

API Drive Activity состоит из ресурса DriveActivity , который представляет изменения, внесенные в объекты на Google Диске пользователя, и метода activity.query , который позволяет извлекать информацию об этих изменениях.

Запрос

Ваше приложение запрашивает данные об активности пользователя с помощью метода activity.query . Вы можете запросить активность как для конкретного элемента Диска, так и для всех данных, содержащихся в папке Диска. Для конкретного запроса вы можете ограничить ответ, используя фильтр , например, по временному диапазону или типу действия, а также включить консолидацию активности в ответе. Подробнее см. в статье Выполнение запросов в API активности Google Диска .

Ответ

Ответ содержит список действий, соответствующих заданным параметрам, где ресурс DriveActivity представляет каждое действие:

Пояснение к сообщению тела ответа Drive Activity API.
Рисунок 1. Пояснение к сообщению тела ответа Drive Activity API.

Ресурс 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 .