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_CRASHNATIVE_CRASHANR。示例:errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH
  • errorIssueId:仅匹配属于所请求错误问题 ID 的错误报告。示例:errorIssueId = 1234 OR errorIssueId = 4567
  • appProcessState:匹配有关应用进程状态的错误报告,该状态指示应用是在前台(用户可见)运行还是在后台运行。有效的候选项:FOREGROUNDBACKGROUND。示例:appProcessState = FOREGROUND
  • isUserPerceived:匹配用户感知的错误报告。它不附带任何运算符。示例:isUserPerceived

** 支持的运算符:**

  • 比较运算符:唯一支持的比较运算符是等式。过滤后的字段必须显示在比较项的左侧。
  • 逻辑运算符:逻辑运算符 ANDOR 可用于构建遵循合取范式 (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 概览