Reports API:修订历史记录

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本页列出了 Reports API (v1) 变更和文档更新。

2020 年 5 月 14 日

企业群组活动报告中添加了新参数 member_type。有效的成员类型包括用户、群组、服务帐号和其他。

2019 年 7 月 30 日

应用制作工具和 Apps 脚本的客户使用情况报告已弃用,最终将从 API 中移除。

2018 年 10 月 22 日

Google+ 社群报告的 Community_name 参数现在仅适用于您的组织内的社区。

2018 年 8 月 1 日

实体使用情况报告的过往数据可用性已更改为 30 天。

2018 年 6 月 4 日

我们修复了以下问题:针对某些 Google+ 社群漏报了一些实体使用情况参数。此问题已于 2018 年 5 月 25 日得到纠正。

2017 年 12 月 11 日

我们创建了实体使用情况报告,以为您帐号的用户所使用的实体生成相关报告。该 API 目前支持为 Google+ 社群生成报告。

2017 年 7 月 11 日

Google+ 客户使用情况报告中新增了 9 个参数。新参数包括:

  • 社区数
  • num_communities_public
  • num_communities_private
  • num_communuies_organization_wide
  • num_communities_organization_private
  • 集合数
  • 集合数(公共)
  • 集合数(组织总数)
  • num_collections_organization_private
此外,Google+ 用户使用情况报告是使用七个指标创建的:

  • 分享次数
  • num_plusones
  • 收到 num_plusones_received 的次数
  • 回复次数
  • 已接收回复数
  • 转发次数
  • 获得的分享次数

2017 年 5 月 11 日

我们在 customerUsageReports.get 方法中添加了应用制作工具Apps 脚本客户使用情况报告。借助这些新报告,您可以查看您网域中应用制作工具和 Apps 脚本的使用情况信息。

2017 年 4 月 5 日

Google 文档客户和使用情况报告即将被 Google 云端硬盘客户和使用情况指标取代。有关详情,请参阅更新云端硬盘和文档指标

2017 年 3 月 14 日

Google+ 客户使用情况报告中添加了六个新参数。新参数包括:

  • 新用户数
  • 分享次数
  • 转发次数
  • num_plusones
  • 回复次数
  • num_stream_items_read

2015 年 2 月 2 日

我们在 customerUsageReports.get 方法中添加了移动设备客户使用情况报告。借助此新报告,您可以查看您网域中移动设备的使用情况信息。

我们修订了版本说明,添加了 Chrome 操作系统报告,该报告已于 2014 年 10 月 27 日发布。

2014 年 12 月 11 日

我们在 activity.list 方法中添加了 Google 日历审核报告。借助此新报告,您可以查看网域中用户的日历和日历活动的变化信息。

2014 年 11 月 20 日

我们在 customerUsageReports.get 方法中添加了 Google 协作平台客户使用情况报告。借助这份新报告,您可以查看您网域中 Google 协作平台的使用情况信息。

2014 年 11 月 12 日

我们在 activity.list 方法中添加了 OAuth 令牌审核报告应用。借助此新报告,您可以查看您网域中已授予访问权限的第三方网站和应用的相关信息。

2014 年 10 月 29 日

Gmail 客户使用情况报告中新增了一些参数。新参数包括:

  • 已送达电子邮件数量
  • 接收入站电子邮件的数量
  • 接收电子邮件总数
  • 垃圾邮件数量
  • 非垃圾邮件数量
  • 已加密邮件数量
  • 未加密的电子邮箱数
  • 已发出的电子邮件数量
  • 接收出站电子邮件的数量
  • 接收出站电子邮件的数量
  • 已加密电子邮件数量
  • 未加密的出站电子邮件数量

2014 年 10 月 27 日

我们在 customerUsageReports.get 方法中添加了 Chrome 操作系统设备客户使用情况报告。借助这份新报告,您可以查看您网域中 Chrome 操作系统设备的使用情况信息。

2014 年 9 月 2 日

用量报告的最长有效期已从 180 天提高到 450 天。 由于此更改需要一段时间才能填充到数据中,因此完整的 450 天历史记录将于 2015 年 5 月 30 日提供,最早的记录日期为 2014 年 3 月 6 日。

2014 年 8 月 15 日

云端硬盘活动报告中添加了新的 view 事件

2014 年 6 月 25 日

Reports API 中现已提供云端硬盘活动报告。这份新报告深入介绍了云端硬盘活动,以及您的帐号用户如何管理、修改和共享其 Google 云端硬盘文档。此报告仅适用于 G Suite 商务版客户,取代了 Google 文档活动报告。Google 文档活动报告现已弃用,并将于 2015 年 1 月 31 日停止运行。

2014 年 6 月 5 日

客户用户 Gmail 报告现在都包含默认值。例如,如果用户未发送电子邮件,num_emails_sent 参数会返回 0。以前,如果某个字段没有任何数据,报表中就会省略该字段。

2014 年 5 月 27 日

Reports API 现在会在客户使用情况报告中包含已暂停用户的使用情况统计信息。

2014 年 4 月 23 日

该 API 返回不含数据的参数的方式已发生变化。以前,如果没有任何数据,则报告中将不会显示该参数。例如,如果用户在报告日期未发送任何电子邮件,Gmail 用户使用情况报告将不会在响应中包含 num_emails_sent 字段。现在,API 会返回整数,默认值为 0(布尔值)和 false(布尔值)。

2014 年 4 月 15 日

客户帐号使用情况报告中添加了新的 num_users_2sv_not_enrolled_but_enforced 参数。这一新参数会指明已强制执行两步验证但尚未注册的网域用户的数量。

2014 年 3 月 27 日

登录审核事件中新增了两个 login_failure_type 值:login_failure_account_disabledlogin_failure_unknown

针对导致过滤器使用区分大小写的比较方式的问题进行了修复。所有过滤条件现在都不区分大小写。

2014 年 3 月 5 日

针对导致针对单个用户的查询忽略过滤条件并始终返回单个记录的问题,我们修复了一个问题。修复后,如果用户不符合过滤条件,则查询同时包含过滤条件的单个用户将不会返回任何结果。

2014 年 2 月 28 日

针对某个问题,修复了导致活跃用户数增加 1 天这一问题的统计信息。2014 年 2 月 24 日之后,部分网域的报告活跃用户报告数量可能有所减少。受影响的字段包括:

  • 帐号
    • 登录次数
    • 登录次数
    • 登录次数 30 天
  • Google 日历
    • _1 天活跃用户数
    • _7 天活跃用户数
  • Google 文档
    • _1 天活跃用户数
    • _7 天活跃用户数
    • 30 天活跃用户数
  • Gmail
    • _1 天活跃用户数
    • _7 天活跃用户数
    • 30 天活跃用户数
  • Google+
    • _1 天活跃用户数
    • _7 天活跃用户数

此外,客户帐号使用情况用户帐号使用情况报告中新增了几个字段。新字段包括:

  • 客户帐号
    • 授权应用数
    • 已授权的应用
    • drive_used_quota_in_mb [占用的存储空间配额]
    • gmail_used_quota_in_mb
    • gplus_photos_used_quota_in_mb
    • 总配额
    • 二手配额
    • 应用许可总数
    • 使用的许可数
    • 保险柜许可总数
    • 协调中心许可总数
  • 用户帐号
    • 授权应用数
    • drive_used_quota_in_mb [占用的存储空间配额]
    • gmail_used_quota_in_mb
    • gplus_photos_used_quota_in_mb
    • 总配额
    • 二手配额
    • used_quota_in_percentage

2014 年 2 月 10 日

已暂停的用户现已纳入 Google 文档报告的统计信息中。某些网域可能会注意到报告的文档数有所增加。

用户使用情况报告中添加了以下参数:

  • 帐号
    • used_quota_in_percentage
  • 文档
    • num_docs_externally_visible
    • num_docs_internally_visible
  • Gmail
    • num_emails_exchanged

2014 年 1 月 27 日

添加了针对活动资源更改的推送通知。该 API 在 API 中以两种新方法(activities.watchchannels.stop)的形式提供,可用于开始和停止接收通知。

2013 年 12 月 3 日

新增了对转销商的支持,以检索特定客户的用量报告和审核信息。它在 API 中作为 activities.listcustomerUsageReports.getuserUsageReport.get 方法的新 customerId 参数公开。

2013 年 4 月

本部分重点介绍 Reports API 与已弃用的 G Suite Admin Audit API (v1) 之间的一些差异。有关 Reports API 的管理员活动的详细信息,请参阅开发者指南API 参考管理员活动事件参考

API 功能 Reports API (v1) 弃用了 Admin Audit API (v1)
applicationIdapplicationName 管理员活动报告使用 applicationName: "admin" 标识管理控制台。如需了解详情,请参阅 API 参考文档 Admin Audit API 通过 "applicationId": "207535951991" 标识管理控制台应用。
控制台的 CSV 导出功能 在此版本的 Reports API 中,此功能不受支持。 Admin Audit API 支持此功能。
eventTypetype 管理员活动报告会返回 type 参数。 Admin Audit API 使用 eventType 作为事件类别。
OAuth 和 OAuth 范围 Reports API 使用 OAuth 2.0 协议。 Reports API 不支持 Admin Audit API OAuth 范围。
分页 对于具有多个响应页面的报告,Reports API 支持使用 maxResultspageToken 查询字符串以及 nextPageToken 响应参数。 Admin Audit API 支持 maxResultsrelnext 参数。
资源网址 管理员活动报告中有一个未使用 customerId 的其他网址。管理员活动报告网址为 https://www.googleapis.com/admin/reports/v1/activity/users/userKey | all/applications/admin Admin Audit API 网址为 https://www.googleapis.com/apps/reporting/audit/v1/the customer ID/the application ID
时间和日期格式 Reports API 请求采用 ISO 8601 yyyy-mm-dd 格式的支持时间。Reports API 响应采用 UNIX 纪元时间,以秒为单位。 Admin Audit API 使用 UTC 格式。