Method: entityUsageReports.get

enum (EntityType)

表示报告的实体类型。

string

表示用于过滤数据的对象的键。这是一个字符串，可以采用值 all 来获取所有用户的活动事件，也可以采用应用专用实体的任何其他值。如需详细了解如何获取特定 entityType 的 entityKey，请参阅实体用量参数参考指南。

string

表示发生用量的日期，以 UTC-8:00（太平洋标准时间）为准。时间戳采用 ISO 8601 格式 yyyy-mm-dd。

string

要检索数据的客户的唯一 ID。

string

filters 查询字符串是应用事件参数的逗号分隔列表，其中参数的值由关系运算符进行处理。filters 查询字符串包含报告中返回其使用情况的应用的名称。“实体使用情况”报告的应用值包括 accounts、docs 和 gmail。

过滤条件采用 [application name]:[parameter name][relational operator][parameter value],... 格式。

在此示例中，<>“不等于”运算符在请求的查询字符串中进行了网址编码 (%3C%3E)：

GET
https://www.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-01
?parameters=gplus:community_name,gplus:num_total_members
&filters=gplus:num_total_members%3C%3E0 

关系运算符包括：

• == - '等于'。
• <> - 不等于。它采用网址编码 (%3C%3E)。
• < - 'less than'。它采用网址编码 (%3C)。
• <= - '小于或等于'。它采用网址编码格式 (%3C=)。
• > - '大于'。它采用网址编码（%3E）。
• >= - '大于或等于'。它采用网址编码格式 (%3E=)。

integer (uint32 format)

确定每个回复页面上显示的活动记录数量。例如，如果请求设置了 <span>maxResults=1</span>，并且报告包含两个活动，则报告将包含两个页面。响应的 <span>nextPageToken</span> 属性包含指向第二页的令牌。

string

用于指定下一页的令牌。包含多个页面的报告在响应中具有 nextPageToken 属性。在用于获取报告下一页的后续请求中，在 pageToken 查询字符串中输入 nextPageToken 值。

string

parameters 查询字符串是以英文逗号分隔的事件参数列表，用于优化报告的结果。该参数与特定应用相关联。“实体使用情况”报告的应用值仅为 gplus。
parameter 查询字符串采用 [app_name1:param_name1], [app_name2:param_name2]... 的 CSV 格式。