此页面由 Cloud Translation API 翻译。

Method: accounts.runAccessReport

HTTP 请求
路径参数
请求正文
- JSON 表示法
响应正文
授权范围
试试看！

返回数据访问记录的自定义报告。该报告会记录用户每次读取 Google Analytics 报告数据的情况。访问记录最长会保留 2 年。

用户可为媒体资源请求数据访问报告。用户可以针对任何媒体资源请求报告，但与配额无关的维度只能在 Google Analytics 360 媒体资源上请求。此方法仅适用于管理员。

这些数据访问记录包括 GA4 界面报告、GA4 界面探索、GA4 Data API 以及 Firebase 和可通过关联从 Google Analytics 中检索数据的 AdMob。这些记录不包括媒体资源配置更改，例如添加数据流或更改媒体资源的时区。如需查看配置更改历史记录，请参阅 searchChangeHistoryEvents。

HTTP 请求

POST https://analyticsadmin.googleapis.com/v1alpha/{entity=accounts/*}:runAccessReport

网址采用 gRPC 转码语法。

路径参数

参数

参数
`entity`	`string` 数据访问权限报告支持在媒体资源一级或账号一级请求。如果在账号级别提出请求，数据访问权限报告将包含该账号下所有媒体资源的所有访问权限。若要在房源级别请求，实体应为例如“properties/123”如果是“123”是您的 GA4 媒体资源 ID。若要在账号级别请求，实体应为例如“accounts/1234”如果是“1234”是您的 GA4 账号 ID。

entity

string

数据访问权限报告支持在媒体资源一级或账号一级请求。如果在账号级别提出请求，数据访问权限报告将包含该账号下所有媒体资源的所有访问权限。

若要在房源级别请求，实体应为例如“properties/123”如果是“123”是您的 GA4 媒体资源 ID。若要在账号级别请求，实体应为例如“accounts/1234”如果是“1234”是您的 GA4 账号 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法

JSON 表示法
{ "dimensions": [ { object (`AccessDimension`) } ], "metrics": [ { object (`AccessMetric`) } ], "dateRanges": [ { object (`AccessDateRange`) } ], "dimensionFilter": { object (`AccessFilterExpression`) }, "metricFilter": { object (`AccessFilterExpression`) }, "offset": string, "limit": string, "timeZone": string, "orderBys": [ { object (`AccessOrderBy`) } ], "returnEntityQuota": boolean, "includeAllUsers": boolean, "expandGroups": boolean }

{
  "dimensions": [
    {
      object (AccessDimension)
    }
  ],
  "metrics": [
    {
      object (AccessMetric)
    }
  ],
  "dateRanges": [
    {
      object (AccessDateRange)
    }
  ],
  "dimensionFilter": {
    object (AccessFilterExpression)
  },
  "metricFilter": {
    object (AccessFilterExpression)
  },
  "offset": string,
  "limit": string,
  "timeZone": string,
  "orderBys": [
    {
      object (AccessOrderBy)
    }
  ],
  "returnEntityQuota": boolean,
  "includeAllUsers": boolean,
  "expandGroups": boolean
}

字段
`dimensions[]`	`object (AccessDimension)` 请求并在响应中显示的维度。最多允许 9 个维度。
`metrics[]`	`object (AccessMetric)` 已请求并在响应中显示的指标。最多允许请求 10 个指标。
`dateRanges[]`	`object (AccessDateRange)` 要读取的访问记录的日期范围。如果请求了多个日期范围，则每个响应行都将包含一个从零开始的日期范围索引。如果两个日期范围重叠，则重叠日期的访问记录会同时包含在这两个日期范围的响应行中。最多允许 2 个日期范围。
`dimensionFilter`	`object (AccessFilterExpression)` 通过维度过滤条件，您可以将报告响应限制为与过滤条件匹配的特定维度值。例如，过滤单个用户的访问记录。要了解详情，请参阅维度过滤条件基础知识中的示例。此过滤条件中不能使用指标。
`metricFilter`	`object (AccessFilterExpression)` 通过指标过滤器，您可以将报告响应限制为与过滤器匹配的特定指标值。与 SQL 包含子句类似，在汇总报告行后应用指标过滤条件。维度不能用于此过滤条件。
`offset`	`string (int64 format)` 起始行的行数。第一行计为第 0 行。如果未指定 offset，则视为 0。如果偏移量为零，则此方法将返回具有 `limit` 条目的第一页结果。如需详细了解此分页参数，请参阅分页。
`limit`	`string (int64 format)` 要返回的行数。如果未指定，则返回 10,000 行。无论您要求返回多少行，对于每个请求，API 最多只能返回 10 万行。`limit` 必须为正数。如果剩余行数少于 `limit`，API 返回的行数可能会少于所请求的 `limit` 行数。例如，如果维度“`country`”的可能值少于 300 个，那么当针对“`country`”生成报告时，即使您将“`limit`”设置为更大的值，行数也不会超过 300 行。如需详细了解此分页参数，请参阅分页。
`timeZone`	`string` 此请求的时区（如果已指定）。如果未指定，系统会使用媒体资源的时区。请求的时区用于解读开始时间和结束日期。格式为 IANA 时区数据库 (https://www.iana.org/time-zones) 中的字符串；例如“America/New_York”或“亚洲/东京”
`orderBys[]`	`object (AccessOrderBy)` 指定响应中各行的排序方式。
`returnEntityQuota`	`boolean` 切换是否返回此 Google Analytics 媒体资源配额的当前状态。配额在 AccessQuota 中返回。对于账号级请求，此字段必须为 false。
`includeAllUsers`	`boolean` 可选。确定是否在响应中包含从未进行过 API 调用的用户。如果为 true，则响应将包含所有有权访问指定媒体资源或账号的用户，无论他们是否进行了 API 调用。如果为 false，则仅包含已进行 API 调用的用户。
`expandGroups`	`boolean` 可选。决定是否返回用户群组中的用户。仅当 includeAllUsers 设置为 true 时，此字段才有效。如果为 true，系统便会返回有权访问指定媒体资源或账号的所有用户。如果为 false，则系统将仅返回具有直接访问权限的用户。

响应正文

如果成功，则响应正文包含一个 RunAccessReportResponse 实例。

授权范围

需要以下 OAuth 范围之一：

https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit