Method: vitals.errors.issues.search

搜尋已分組報告中的所有錯誤問題。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必要欄位。錯誤問題的父項資源，表示收到錯誤的應用程式。

格式：apps/{app}

查詢參數

參數
interval

object (DateTimeInterval)

搜尋錯誤問題的日期時間間隔。開始和結束時間都必須以小時為單位，並且使用 UTC 做為時區 (如果留空，系統則會使用 UTC)。

如果啟用這項設定，系統就只會傳回這段期間內發生的相關錯誤報告錯誤。如未指定，系統會使用過去 24 小時的預設間隔。
pageSize

integer

要傳回的錯誤問題數量上限。服務傳回的產品數量可能會少於這個值。

如未指定，最多將傳回 50 個錯誤問題。許可的最大值為 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)

發現的錯誤。
nextPageToken

string

用於擷取下一頁資料的接續權杖。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。