Method: vitals.errors.issues.search

搜索报告已分组的所有错误问题。

HTTP 请求

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{parent=apps/*}/errorIssues:search

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。错误问题的父级资源，表示收到这些问题的应用。

格式：apps/{app}

查询参数

参数
interval

object (DateTimeInterval)

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

如果设置了此参数，则只会返回与在此时间间隔内发生的错误报告相关联的错误问题。如果未指定，则使用默认的过去 24 小时的时间间隔。
pageSize

integer

可选。要返回的错误问题数量上限。服务返回的值可能小于此值。

如果未指定，则最多返回 50 个错误问题。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
pageToken

string

可选。从之前的调用收到的页面令牌。利用其进行后续页面检索。

进行分页时，向请求提供的所有其他参数都必须与提供页面令牌的调用匹配。
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。
  • appProcessState：匹配应用进程状态的错误问题，指示应用是在前台（用户可见）还是后台运行。有效候选值：FOREGROUND、BACKGROUND。 示例：appProcessState = FOREGROUND。
  • isUserPerceived：匹配用户感知的错误问题。它不附带任何运算符。示例：isUserPerceived。

** 支持的运算符：**

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

仅支持使用 OR 运算符构建适用于同一字段的析取，例如，versionCode = 123 OR errorIssueType = ANR 不是有效的过滤条件。

** 示例 **

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

string

可选。指定将用于对结果进行排序的字段。

** 支持的维度：**

  • errorReportCount：按错误报告数量对问题进行排序。
  • distinctUsers：按受影响的唯一用户数量对问题进行排序。

** 支持的操作：**

  • asc 表示升序。
  • desc 表示降序。

格式：字段和操作，例如 errorReportCount desc

注意：目前一次仅支持一个字段。

sampleErrorReportLimit

integer

可选。每个 ErrorIssue 返回的示例错误报告数量。如果未指定，则使用 0。注意：目前仅支持 0 和 1。

请求正文

请求正文必须为空。

响应正文

响应包含与请求匹配的问题的分页列表。

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

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

object (ErrorIssue)

找到的 ErrorIssue。
nextPageToken

string

用于提取下一页数据的续页令牌。

授权范围

需要以下 OAuth 范围：

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

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