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)。
• < -「小於」。此為網址編碼 (%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 格式。