Method: vitals.errors.reports.search

搜索收到的针对应用的所有错误报告。

HTTP 请求

GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/errorReports:search

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。报告的父级资源，用于指明收到报告的应用。

格式：apps/{app}

查询参数

参数
interval

object (DateTimeInterval)

要搜索错误报告的日期时间间隔。开始时间和结束时间都必须与小时对齐，并使用 UTC 作为时区（或为空，在这种情况下也会使用 UTC）。

如果设置，则仅返回在该时间段内发生的错误报告。如果未指定，系统将使用默认时间间隔（过去 24 小时）。
pageSize

integer

要返回的报告数量上限。服务返回的值可能小于此值。

如果未指定，则最多返回 50 份报告。最大值为 100；高于 100 的值将被强制转换为 100。
pageToken

string

从之前的 reports.search 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 reports.search 的所有其他参数必须与提供页面令牌的调用匹配。
filter

string

用于仅检索部分报告的选择谓词。

如需了解过滤的基本知识，请参阅 AIP-160。

** 支持的字段名称：**

  • apiLevel：仅匹配所请求的 Android 版本（以数字 API 级别指定）中发生的错误报告。示例：apiLevel = 28 OR apiLevel = 29。
  • versionCode：仅匹配在所请求的应用版本代码中发生的错误报告。示例：versionCode = 123 OR versionCode = 456。
  • deviceModel：与所请求设备中发生的错误问题相匹配。示例：deviceModel = "google/walleye" OR deviceModel = "google/marlin"。
  • deviceBrand：与所请求设备品牌中发生的错误问题相匹配。示例：`deviceBrand = "Google"。
  • deviceType：匹配所请求设备类型中发生的错误报告。示例：deviceType = "PHONE"。
  • errorIssueType：仅匹配所请求类型的错误报告。有效候选值：CRASH、ANR、NON_FATAL。示例：errorIssueType = CRASH OR errorIssueType = ANR。
  • errorIssueId：仅匹配属于所请求的错误问题 ID 的错误报告。示例：errorIssueId = 1234 OR errorIssueId = 4567。
  • errorReportId：与具有所请求的错误报告 ID 的错误报告匹配。示例：errorReportId = 1234 OR errorReportId = 4567。
  • appProcessState：匹配应用进程状态方面的错误报告，指示应用是在前台（用户可见）还是后台运行。有效候选值：FOREGROUND、BACKGROUND。示例：appProcessState = FOREGROUND。
  • isUserPerceived：匹配用户感知到的错误报告。它不包含任何运算符。示例：isUserPerceived。

** 支持的运算符：**

  • 比较运算符：唯一支持的比较运算符是等值比较。过滤后的字段必须显示在比较的左侧。
  • 逻辑运算符：逻辑运算符 AND 和 OR 可用于按照合取范式 (CNF) 构建复杂的过滤条件，即析取的合取。OR 运算符的优先级高于 AND，因此在构建 CNF 时无需使用圆括号。

OR 运算符仅支持构建应用于同一字段的析取，例如：versionCode = 123 OR versionCode = ANR。过滤表达式 versionCode = 123 OR errorIssueType = ANR 无效。

** 示例 **

一些有效的过滤表达式： * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

请求正文

请求正文必须为空。

响应正文

包含与搜索查询匹配的错误报告的分页列表的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "errorReports": [
    {
      object (ErrorReport)
    }
  ],
  "nextPageToken": string
}
字段
errorReports[]

object (ErrorReport)

发现的错误报告。
nextPageToken

string

用于获取下一页报告的页面令牌。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/playdeveloperreporting

如需了解详情，请参阅 OAuth 2.0 Overview。