傳回資料存取記錄的自訂報表。每當使用者讀取 Google Analytics 報表資料時,報表就會提供記錄。存取記錄最多會保留 2 年。
可要求資源的資料存取報表。您可以為任何資源提出報表要求,但與配額無關的維度只能在 Google Analytics 360 資源中要求。這個方法僅供管理員使用。
這些資料存取記錄包括 Google Analytics UI 報表、Google Analytics UI 探索、Google Analytics Data API,以及 Firebase 和可以透過連結從 Google Analytics 擷取資料的 AdMob。這些記錄不包含資源設定變更 (例如新增串流或變更資源的時區)。如需瞭解設定變更記錄,請參閱 searchChangeHistoryEvents。
如要提供有關這個 API 的寶貴意見,請填寫 Google Analytics 存取報表意見回饋表單。
HTTP 要求
POST https://analyticsadmin.googleapis.com/v1alpha/{entity=properties/*}:runAccessReport
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
entity |
「資料存取報表」支援在資源或帳戶層級提出要求。若在帳戶層級提出請求,資料存取報表會包含該帳戶下所有資源的所有存取權。 如要在屬性層級提出要求,實體應為「properties/123」表示「123」是您的 Google Analytics 資源 ID。如要在帳戶層級提出要求,實體應為「accounts/1234」表示「1234」是您的 Google Analytics 帳戶 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "dimensions": [ { object ( |
欄位 | |
---|---|
dimensions[] |
要求和顯示在回應中的維度。最多允許 9 個維度。 |
metrics[] |
回應中要求及顯示的指標。最多可有 10 個指標。 |
dateRanges[] |
要讀取的存取記錄日期範圍。如果要求多個日期範圍,則每個回應列都會包含以零為基準的日期範圍索引。如果兩個日期範圍重疊,兩個日期範圍的回應列中都會包含重疊日期的存取權記錄。最多允許 2 個日期範圍的要求。 |
dimensionFilter |
維度篩選器可讓您限制報表只回應符合篩選器的特定維度值。例如,篩選單一使用者的存取記錄。詳情請參閱「維度篩選器的基本知識」一文。無法在這個篩選器中使用指標。 |
metricFilter |
您可以運用指標篩選器,限制報表回應僅適用於符合篩選器的特定指標值。如同 SQL 包含子句,系統會在匯總報表的資料列後套用指標篩選器。無法在這個篩選器中使用維度。 |
offset |
起始資料列的列數。第一列會計為第 0 列。如果未指定偏移值,系統會將其視為 0。如果偏移值為零,這個方法會傳回第一頁的結果,內含 如要進一步瞭解這個分頁參數,請參閱「分頁」。 |
limit |
要傳回的列數。如未指定,系統會傳回 10,000 列。無論您要求多少列,API 在每個要求最多只能傳回 100,000 列資料。 如果 如要進一步瞭解這個分頁參數,請參閱「分頁」。 |
timeZone |
此要求的時區 (如有指定)。如果未指定,則會使用屬性的時區。要求的時區是用於解讀開始時間和報表的結束日期 採用 IANA 時區資料庫 (https://www.iana.org/time-zones) 的字串;例如「America/New_York」或「亞洲/東京」 |
orderBys[] |
指定在回應中資料列的排序方式。 |
returnEntityQuota |
切換是否要傳回這項 Analytics 資源的配額目前狀態。配額會在 AccessQuota 中傳回。如果是帳戶層級請求,這個欄位必須為 false。 |
includeAllUsers |
選用設定。決定是否要在回應中加入從未發出 API 呼叫的使用者。設為 true 時,無論是否發出 API 呼叫,凡是可存取指定資源或帳戶的使用者,都會納入回應中。如果設為 False,系統只會納入已發出 API 呼叫的使用者。 |
expandGroups |
選用設定。決定是否要傳回使用者群組中的使用者。只有在 includeAllUsers 設為 true 時,才能使用這個欄位。若為 true,則會傳回所有可存取指定資源或帳戶的使用者。如果設為 False,系統只會傳回具備直接存取權的使用者。 |
回應主體
如果成功,回應主體會包含 RunAccessReportResponse
的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit