API отчетов: история изменений

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

На этой странице перечислены изменения и обновления документации Reports API (v1).

14 мая 2020 г.

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

30 июля 2019 г.

Отчеты об использовании клиентами для App Maker и Apps Script устарели и в конечном итоге будут удалены из API.

22 октября 2018 г.

Параметр community_name для отчета о сообществах Google+ теперь доступен только для сообществ внутри вашей организации.

1 августа 2018 г.

Доступность прошлых данных для отчета об использовании сущностей изменена на 30 дней.

4 июня 2018 г.

Мы исправили проблему, из-за которой некоторые параметры использования сущностей были занижены для некоторых сообществ Google+ . Исправлено 25.05.2018.

11 декабря 2017 г.

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

11 июля 2017 г.

В отчет об использовании Google+ пользователями добавлено девять новых параметров. Новые параметры:

  • num_communities
  • num_communities_public
  • num_communities_private
  • num_communuties_organization_wide
  • num_communities_organization_private
  • количество_коллекций
  • num_collections_public
  • num_collections_organization_wide
  • num_collections_organization_private
Кроме того, был создан отчет об использовании Google+ с семью показателями:

  • num_shares
  • num_plusones
  • num_plusones_received
  • количество_ответов
  • num_replies_received
  • num_reshares
  • num_reshares_received

11 мая 2017 г.

Мы добавили отчеты об использовании клиентами App Maker и Apps Script в метод customerUsageReports.get . Эти новые отчеты позволяют просматривать информацию об использовании Конструктора приложений и скриптов приложений в ваших доменах.

5 апреля 2017 г.

Отчеты о клиентах и ​​использовании Документов Google заменяются показателями клиентов и использования Google Диска. Подробнее см. в статье Обновление показателей Диска и Документов .

14 марта 2017 г.

В отчет об использовании Google+ пользователями добавлено шесть новых параметров. Новые параметры:

  • num_new_users
  • num_shares
  • num_reshares
  • num_plusones
  • количество_ответов
  • num_stream_items_read

2 февраля 2015 г.

Мы добавили отчет об использовании мобильных устройств клиентами в метод customerUsageReports.get . Этот новый отчет позволяет просматривать информацию об использовании мобильных устройств в ваших доменах.

Мы внесли изменения в примечания к выпуску, включив в них отчет ChromeOS, выпущенный 27 октября 2014 г.

11 декабря 2014 г.

Мы добавили отчет аудита Календаря Google в метод activity.list . Этот новый отчет позволяет просматривать информацию об изменениях в календарях и событиях календаря для пользователей в вашем домене.

20 ноября 2014 г.

Мы добавили отчет об использовании Google Sites клиентами в метод customerUsageReports.get . Этот новый отчет позволяет просматривать информацию об использовании Сайтов Google в ваших доменах.

12 ноября 2014 г.

Мы добавили приложение для создания отчетов OAuth Token Audit в метод activity.list. Этот новый отчет позволяет просматривать информацию о сторонних веб-сайтах и ​​приложениях, к которым пользователи в ваших доменах предоставили доступ.

29 октября 2014 г.

В отчет об использовании клиентов Gmail добавлены новые параметры. Новые параметры:

  • num_inbound_delivered_emails
  • num_inbound_rerouted_emails
  • num_inbound_rejected_emails
  • num_inbound_spam_emails
  • num_inbound_non_spam_emails
  • num_inbound_encrypted_emails
  • num_inbound_unencrypted_emails
  • num_outbound_delivered_emails
  • num_outbound_rerouted_emails
  • num_outbound_rejected_emails
  • num_outbound_encrypted_emails
  • num_outbound_unencrypted_emails

27 октября 2014 г.

Мы добавили отчет об использовании устройств ChromeOS клиентами в метод customerUsageReports.get . Этот новый отчет позволяет просматривать информацию об использовании устройств ChromeOS в ваших доменах.

2 сентября 2014 г.

Максимальный срок для отчетов об использовании был увеличен со 180 до 450 дней. Поскольку для внесения этого изменения в наши данные потребуется время, полная история за 450 дней будет доступна 30 мая 2015 г., а самая ранняя доступная дата — 6 марта 2014 г.

15 августа 2014 г.

В отчет об активности на Диске добавлено новое событие view .

25 июня 2014 г.

Отчет об активности на Диске теперь доступен в Reports API. Этот новый отчет предоставляет информацию о действиях на Диске и о том, как пользователи вашей учетной записи управляют, изменяют и делятся своими документами на Google Диске. Этот отчет доступен только для клиентов G Suite Business и заменяет отчет об активности Google Docs. Отчет об активности в Документах Google устарел и перестанет функционировать 31 января 2015 г.

5 июня 2014 г.

Отчеты Gmail о клиентах и ​​пользователях теперь содержат значения по умолчанию. Например, если пользователь не отправляет электронную почту, параметр num_emails_sent возвращается как 0. Раньше, если для поля не было данных, это поле исключалось из отчета.

27 мая 2014 г.

Reports API теперь включает статистику использования заблокированных пользователей в отчетах об использовании Customers Usage .

23 апреля 2014 г.

Внесено изменение в то, как API возвращает параметры без данных. Ранее, если для параметра не было данных, он отсутствовал в отчете. Например, отчет об использовании Gmail пользователем не будет включать поле num_emails_sent в ответ, если пользователь не отправлял никаких электронных писем в дату отчета. API теперь возвращает эти параметры со значением по умолчанию 0 для целых чисел и false для логических значений.

15 апреля 2014 г.

В отчет об использовании учетных записей клиентов добавлен новый параметр num_users_2sv_not_enrolled_but_enforced . Этот новый параметр указывает количество пользователей домена, для которых включена двухэтапная проверка, но которые не зарегистрировались.

27 марта 2014 г.

Два новых значения login_failure_type были добавлены в события аудита входа : login_failure_account_disabled и login_failure_unknown .

Исправлена ​​ошибка, из-за которой фильтры использовали сравнения с учетом регистра. Все фильтры теперь нечувствительны к регистру.

5 марта 2014 г.

Исправлена ​​ошибка, из-за которой фильтры игнорировались в запросах для отдельных пользователей и всегда возвращали одну запись. После исправления запросы для отдельных пользователей, которые также включают фильтры, не будут возвращать результат, если пользователь не соответствует критериям фильтра.

28 февраля 2014 г.

Исправлена ​​ошибка, из-за которой некоторые статистические данные о количестве активных пользователей включали один дополнительный день. После 24 февраля 2014 года в некоторых доменах может наблюдаться уменьшение количества активных пользователей, зарегистрированных в отчетах. Затронутые поля:

  • учетные записи
    • num_1day_logins
    • num_7day_logins
    • num_30day_logins
  • Календарь Google
    • num_1day_active_users
    • num_7day_active_users
  • Гугл документы
    • num_1day_active_users
    • num_7day_active_users
    • num_30day_active_users
  • Gmail
    • num_1day_active_users
    • num_7day_active_users
    • num_30day_active_users
  • Google+
    • num_1day_active_users
    • num_7day_active_users

Кроме того, недавно в отчеты «Использование учетной записи клиента» и «Использование учетной записи пользователя» было добавлено несколько новых полей. Новые поля:

  • Аккаунты клиентов
    • num_authorized_apps
    • авторизованные_приложения
    • drive_used_quota_in_mb
    • gmail_used_quota_in_mb
    • gplus_photos_used_quota_in_mb
    • total_quota_in_mb
    • used_quota_in_mb
    • apps_total_licenses
    • apps_used_licenses
    • vault_total_licenses
    • Координата_total_licenses
  • Учетные записи пользователей
    • num_authorized_apps
    • drive_used_quota_in_mb
    • gmail_used_quota_in_mb
    • gplus_photos_used_quota_in_mb
    • total_quota_in_mb
    • used_quota_in_mb
    • used_quota_in_percentage

10 февраля 2014 г.

Заблокированные пользователи теперь включаются в статистику отчетов Документов. Некоторые домены могут заметить увеличение количества сообщаемых документов.

В отчет об использовании пользователя добавлены следующие параметры:

27 января 2014 г.

Добавлены push-уведомления об изменениях в ресурсе Activity . Это представлено в API как два новых метода, channels.stop activities.watch для запуска и прекращения получения уведомлений.

3 декабря 2013 г.

Для торговых посредников добавлена ​​поддержка получения отчетов об использовании и информации аудита для конкретного клиента. Это отображается в API как новый параметр customerId для методов userUsageReport.get , customerUsageReports.get и activities.list .

Апрель 2013

В этом разделе освещаются некоторые различия между API отчетов и устаревшим API аудита администратора G Suite (v1). Дополнительные сведения о действиях администратора в API отчетов см. в Руководстве разработчика , Справочнике по API и справочнике по событиям действий администратора .

Функции API API отчетов (v1) Устаревший API аудита администратора (v1)
applicationId и applicationName В отчете о действиях администратора используется applicationName: "admin" для идентификации консоли администратора. Для получения дополнительной информации см. Справочник по API . API аудита администратора идентифицирует приложение консоли администратора с помощью "applicationId": "207535951991" .
Функция экспорта CSV панели управления В этой версии Reports API эта функция не поддерживается. Это поддерживается в Admin Audit API.
Тип eventType и type Отчет об активности администратора возвращает параметр type . API аудита администратора использует eventType события для категории событий.
OAuth и область действия OAuth API отчетов использует протокол OAuth 2.0. Область OAuth API аудита администратора не поддерживается в API отчетов.
Пагинация Для отчетов с несколькими страницами ответов API отчетов поддерживает строки запроса maxResults и pageToken а также параметр ответа nextPageToken . API аудита администратора поддерживает maxResults , rel и next .
URL-адреса ресурсов Отчет об активности администратора имеет другой URL-адрес, в котором не используется customerId . URL-адрес отчета об активности администратора: https://www.googleapis.com/admin/reports/v1/activity/users/ userKey | all/applications/admin URL-адрес API аудита администратора – это https://www.googleapis.com/apps/reporting/audit/v1/ the customer ID / the application ID
Формат времени и даты API отчетов запрашивает время поддержки в формате ISO 8601 гггг-мм-дд. Ответы API отчетов представлены в формате времени эпохи UNIX в секундах. API аудита администратора использует формат UTC.