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 个错误问题。最大值为 1000；大于 1000 的值将被强制转换为 1000。
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。示例：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

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

请求正文

请求正文必须为空。

响应正文

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

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

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

object (ErrorIssue)

发现的 ErrorIssues。
nextPageToken

string

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

授权范围

需要以下 OAuth 作用域：

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

有关详情，请参阅 OAuth 2.0 概览。