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:僅比對要求類型的錯誤問題。有效的候選項目:CRASHANR。範例:errorIssueType = CRASH OR errorIssueType = ANR
  • appProcessState:比對應用程式程序狀態的錯誤問題,指出應用程式是在前景 (使用者可以看見) 還是背景執行。有效的候選項目:FOREGROUNDBACKGROUND。範例:appProcessState = FOREGROUND
  • isUserPerceived:比對使用者感知的錯誤問題。此屬性不會附帶任何運算子。例如:isUserPerceived.

** 支援的運算子:**

  • 比較運算子:系統僅支援「相等」比較運算子。經過篩選的欄位必須顯示在比較的左側。
  • 邏輯運算子:邏輯運算子 ANDOR 可用來建構符合正規化正規格式 (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 總覽