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。