На этой странице перечислены изменения и обновления документации 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
- 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 г.
Заблокированные пользователи теперь включаются в статистику отчетов Документов. Некоторые домены могут заметить увеличение количества сообщаемых документов.
В отчет об использовании пользователя добавлены следующие параметры:
- учетные записи
-
used_quota_in_percentage
-
- Документы
-
num_docs_externally_visible
-
num_docs_internally_visible
-
- Gmail
-
num_emails_exchanged
-
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. |