返回数据访问记录的自定义报告。该报告会提供用户每次读取 Google Analytics(分析)报告数据的记录。访问记录最长会保留 2 年。
您可以为媒体资源申请数据访问报告。您可以针对任何媒体资源请求报告,但与配额无关的维度只能针对 Google Analytics 360 媒体资源请求。此方法仅供管理员使用。
这些数据访问记录包括 GA4 界面报告、GA4 界面探索、GA4 Data API,以及可通过关联从 Google Analytics(分析)中检索数据的其他产品,例如 Firebase 和 AdMob。这些记录不包含媒体资源配置更改(例如添加数据流或更改媒体资源的时区)。如需了解配置更改历史记录,请参阅 searchChangeHistoryEvents。
HTTP 请求
POST https://analyticsadmin.googleapis.com/v1alpha/{entity=accounts/*}:runAccessReport
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
entity |
数据访问报告支持在媒体资源一级或帐号一级提出请求。如果在帐号一级提出请求,则数据访问报告将包含该帐号下所有媒体资源的所有访问权限。 若要在媒体资源一级发出请求,如果“123”是您的 GA4 媒体资源 ID,则实体应为“properties/123”。如需在帐号级别请求,实体应为“accounts/1234”(如果“1234”是您的 GA4 帐号 ID)。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "dimensions": [ { object ( |
字段 | |
---|---|
dimensions[] |
请求并在响应中显示的维度。请求最多允许使用 9 个维度。 |
metrics[] |
已请求并在响应中显示的指标。最多可以请求 10 个指标。 |
dateRanges[] |
要读取的访问记录的日期范围。如果请求了多个日期范围,则每个响应行都会包含一个从 0 开始的日期范围索引。如果两个日期范围重叠,则重叠日期的访问记录将同时包含在这两个日期范围的响应行中。请求最多允许 2 个日期范围。 |
dimensionFilter |
利用维度过滤条件,您可以将报告响应限制为与过滤条件匹配的特定维度值。例如,按单个用户的访问记录进行过滤。如需了解详情,请参阅维度过滤条件基础知识中的相关示例。此过滤条件中不能使用指标。 |
metricFilter |
利用指标过滤条件,您可以将报告响应限制为与过滤条件匹配的特定指标值。指标过滤条件在汇总报告行之后应用,类似于 SQL using-clause。此过滤条件中不能使用维度。 |
offset |
起始行的行数。第一行计为第 0 行。如果未指定偏移量,则会被视为 0。如果 offset 为零,此方法将返回第一页含有 如需详细了解此分页参数,请参阅分页。 |
limit |
要返回的行数。如果未指定,则返回 10,000 行。无论您请求返回多少行,每个请求最多返回 100,000 行。“ 如果剩余行数少于 如需详细了解此分页参数,请参阅分页。 |
timeZone |
此请求的时区(如果已指定)。如果未指定,系统将使用媒体资源的时区。请求的时区用于解读报告的开始日期和结束日期。 格式为 IANA 时区数据库 (https://www.iana.org/time-zones) 中的字符串;例如“America/New_York”或“Asia/Tokyo”。 |
orderBys[] |
指定响应中的行排序方式。 |
returnEntityQuota |
切换是否返回此 Google 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