对 Google Analytics Admin API 的 Data Access Reports 方法进行查询时支持的维度和指标。
维度
您可以在数据访问报告中请求以下维度。在报告响应中，为维度列在 AccessDimension 资源的维度 name 字段中指定“API 名称”。
| API 名称 | 界面名称 | 允许的媒体资源 | 说明 |
|---|---|---|---|
accessDateHour |
访问日期时间 | 所有 Google Analytics 媒体资源 | 访问 Google Analytics 报告数据的 Google Analytics 用户的日期时间（小时）。格式为 YYYYMMDDHH。 |
accessMechanism |
访问机制 | Google Analytics 360 媒体资源 | GA 用户访问 GA 报告数据的机制。可能的值包括“Google Analytics 界面”“Google Analytics API”“Firebase”“Google Ads”等。 |
accessedPropertyId |
访问的媒体资源 ID | 所有 Google Analytics 媒体资源 | 访问 GA 报告数据的媒体资源 ID。大多数数据访问报告仅包含一个媒体资源，但如果请求的媒体资源具有子媒体资源，则数据访问报告会同时包含对来源媒体资源和子媒体资源的访问。如需了解详情，请参阅子媒体资源简介。 |
accessedPropertyName |
访问的媒体资源名称 | 所有 Google Analytics 媒体资源 | 访问 Google Analytics 报告数据的媒体资源显示名称。大多数数据访问报告仅包含一个媒体资源，但如果请求的媒体资源具有子媒体资源，则数据访问报告会同时包含对来源媒体资源和子媒体资源的访问。如需了解详情，请参阅子媒体资源简介。 |
accessorAppName |
访问器应用名称 | 所有 Google Analytics 媒体资源 | 访问 Google Analytics 报告数据的应用的名称。您向第三方应用和服务授予了查看您的 Google Analytics 报告数据的权限。如需了解详情，请参阅管理 Google 账号与第三方之间的关联。 |
costDataReturned |
返回的费用数据 | Google Analytics 360 版媒体资源 | 如果此报告中返回了费用数据，则返回 true。否则，此维度会返回 false。受“无费用指标”限制的 Google Analytics 用户无法查看费用指标。当该限制有效时，该维度将始终为 false。如需了解详情，请参阅访问权限和数据限制管理。 |
dataApiQuotaCategory |
Data API 配额类别 | 所有 Google Analytics 媒体资源 | Data API 请求的配额类别。可能的值包括“核心”“实时”和“漏斗”。 |
epochTimeMicros |
纪元时间（以微秒为单位） | Google Analytics 360 版媒体资源 | Google Analytics 用户访问 Google Analytics 报告数据以来的 Unix 微秒数。例如，Unix 微秒数“1655220215027371”对应的是 2022-06-14 11:23:35（美国/纽约）。 |
mostRecentAccessEpochTimeMicros |
最近一次访问的纪元时间（以微秒为单位） | Google Analytics 360 版媒体资源 | 此行的最新访问时间戳。以自 Unix 纪元以来的微秒数返回。通常与“userEmail”和类似维度搭配使用，用于确定 Google Analytics 用户的最近访问时间。 |
reportType |
报告类型 | Google Analytics 360 媒体资源 | GA 用户访问过的报告数据的类型。可能的值包括“报告”“实时”“自由形式探索”“漏斗探索”等。 |
revenueDataReturned |
返回的收入数据 | Google Analytics 360 版媒体资源 | 如果相应报告中返回了收入数据，则返回 true。否则，此维度会返回 false。受“无收入指标”限制的 Google Analytics 用户无法查看收入指标。当该限制有效时，该维度将始终为 false。如需了解详情，请参阅如何管理访问权限和数据限制。 |
userCountry |
用户所在国家/地区 | Google Analytics 360 媒体资源 | 访问过 Google Analytics 报告数据的 Google Analytics 用户所在的国家/地区。 |
userCountryId |
用户所在国家/地区 ID | Google Analytics 360 媒体资源 | 访问 Google Analytics 报告数据的 Google Analytics 用户的国家/地区 ID。格式遵循 ISO 3166-1 alpha-2 标准。 |
userEmail |
用户的电子邮件地址 | 所有 Google Analytics 媒体资源 | 访问 GA 报告数据的 GA 用户的电子邮件地址。某些集成允许用户通过集成访问 GA 报告数据，而无需直接访问媒体资源；在这种情况下，“userEmail”将返回“Google Ads 关联的用户”等值，具体取决于集成。 |
userIP |
用户 IP | Google Analytics 360 版媒体资源 | 访问 Google Analytics 报告数据的 Google Analytics 用户的 IP。 |
指标
可以在数据访问报告中请求以下指标。在报告响应中，为指标列在 AccessMetric 资源的指标 name 字段中指定“API 名称”。
| API 名称 | 界面名称 | 允许的媒体资源 | 说明 |
|---|---|---|---|
accessCount |
访问次数 | Google Analytics 360 媒体资源 | Google Analytics 报告数据的访问次数。使用 Google Analytics 界面时，每张报告卡片都可能导致一个或多个数据访问事件。因此，浏览 Google Analytics 界面可能会导致访问事件数多于查看的报告数量。 |
dataApiQuotaPropertyTokensConsumed |
已使用的 Data API 配额媒体资源令牌 | 所有 Google Analytics 媒体资源 | 返回 Data API 请求消耗的媒体资源配额令牌总数。 |