Обзор API отчетов

Reports API – это RESTful API, который можно использовать для доступа к информации о действиях ваших пользователей в Google Workspace. API отчетов является частью API Admin SDK.

API отчетов предоставляет два типа отчетов:

  • Отчеты о действиях , в которых сообщается о событиях для определенного приложения или службы, например Google Диска или консоли администратора.
  • Отчеты об использовании , в которых перечислены события рабочей области, вызванные пользователями.
    • В отчетах об использовании клиентов перечислены события для всех пользователей вашего домена.
    • В отчетах об использовании пользователей перечислены события, организованные пользователем.

Ниже приведен список общих терминов, используемых в API отчетов:

Отчеты о деятельности

В отчетах о действиях содержится информация о действиях в конкретном приложении или сервисе Google Workspace. Отчеты о деятельности включают дату, время, пользователя и тип активности. Справочник по API содержит полный список отчетов о деятельности и содержащуюся в них информацию. Вот несколько примеров отчетов о деятельности, перечисленных по приложениям или службам:

  • Отчеты о действиях администратора показывают действия, выполненные администраторами с помощью консоли администратора. Например, вы можете получить список всех случаев, когда администраторы меняли имя пользователя, с помощью консоли администратора.
  • В отчетах о действиях на Google Диске показано, как пользователи вашего домена редактируют и просматривают свои документы на Диске. Например, вы можете получить список действий конкретного пользователя на Диске.
  • Отчеты о действиях при входе в систему предоставляют информацию о том, когда пользователи вашей учетной записи входят в свои учетные записи и выходят из них. Например, вы можете получить отчет обо всех входах в ваш домен за определенный период времени.
  • Отчеты о мобильных действиях показывают действия с использованием мобильных устройств, управляемых Google Mobile Management . Например, вы можете получать уведомления, когда пользователи регистрируют новое устройство.
  • В отчетах о активности токенов OAuth перечислены события, когда ваши пользователи предоставили или отозвали токены авторизации, используемые сторонними веб-сайтами и приложениями. Вы можете использовать API отчетов, чтобы получить список всех сторонних пользователей, имеющих доступ к данным Google Workspace пользователя.
Отчеты об использовании

Отчеты об использовании содержат информацию о событиях Google Workspace в вашем домене. Вы можете использовать API для запроса конкретной информации о пользователях.

  • В отчетах об использовании клиентов перечислены подробные сведения о действиях приложений и служб в вашей учетной записи. Эта информация об использовании организована по типу приложения и содержит информацию, специфичную для этого приложения.
  • Отчеты об использовании пользователей показывают действия пользователей вашей учетной записи. Эти отчеты можно настраивать и фильтровать по конкретной информации об использовании. Эта информация об использовании организована по типу приложения и содержит информацию, специфичную для этого приложения.
  • В отчетах об использовании сущностей перечислены действия, связанные с сущностями, используемыми пользователями вашей учетной записи в приложении Currents.
Уведомления
API отчетов предоставляет уведомления, которые позволяют отслеживать события, например изменения в ресурсах. Когда вы просматриваете ресурс и этот ресурс изменяется, API отчетов отправляет вам уведомление. Дополнительную информацию о настройке и получении уведомлений от API отчетов см. в руководстве по получению push-уведомлений .

Следующие шаги