对 Google Analytics Admin API 的 Data Access Reports 方法进行查询时支持的维度和指标。
维度
您可以在数据访问报告中请求以下维度。在报告响应中,为维度列在 AccessDimension 资源的维度 name 字段中指定“API 名称”。
| API 名称 | 界面名称 | 允许的媒体资源 | 说明 | 
|---|---|---|---|
| accessDateHour | 访问日期时间 | 所有 Google Analytics 媒体资源 | Google Analytics 用户访问 Google Analytics 报告数据的日期时间。格式为 YYYYMMDDHH。 | 
| accessMechanism | 访问机制 | Google Analytics 360 版媒体资源 | Google Analytics 用户访问 Google Analytics 报告数据所用的机制。可能的值包括“Google Analytics 界面”“Google Analytics API”“Firebase”“Google Ads”等。 | 
| accessedPropertyId | 访问的媒体资源 ID | 所有 Google Analytics 媒体资源 | 所访问的 Google Analytics 报告数据对应的媒体资源 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 版媒体资源 | Google Analytics 用户访问的报告数据类型。可能的值包括“报告”“实时”“自由形式探索”“漏斗探索”等。 | 
| 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 媒体资源 | 访问 Google Analytics 报告数据的 Google Analytics 用户的电子邮件地址。有些集成允许用户通过集成访问 Google Analytics 报告数据,而无需用户直接访问媒体资源;在这种情况下,“userEmail”将返回“Google Ads Linked User”(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 请求消耗的媒体资源配额令牌总数。 |