Method: vitals.errors.reports.search

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

HTTP 请求

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{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：仅匹配所请求类型的错误报告。有效的候选项：JAVA_CRASH、NATIVE_CRASH、ANR。示例：errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH。
  • errorIssueId：仅匹配属于所请求错误问题 ID 的错误报告。示例：errorIssueId = 1234 OR errorIssueId = 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 概览。