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)

发现的错误问题。
nextPageToken

string

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

授权范围

需要以下 OAuth 范围：

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

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