Method: vitals.errors.issues.search

string

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

格式：apps/{app}

object (DateTimeInterval)

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

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

integer

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

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

string

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

进行分页时，向请求提供的所有其他参数都必须与提供页面令牌的调用匹配。

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)

string

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

** 支持的维度：**

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

** 支持的操作：**

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

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

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

integer

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