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。
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、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)
orderBy

string

指定用於排序結果的欄位。

** 支援的尺寸：**

  • errorReportCount：依錯誤報告數量排序問題。
  • distinctUsers：按照受影響的不重複使用者人數排序問題。

** 支援的作業：**

  • asc 遞增排序。
  • desc 則為遞減順序。

格式：欄位和運算，例如 errorReportCount desc

注意：目前一次只能支援一個欄位。
sampleErrorReportLimit

integer

(選用步驟) 每個 ErrorIssue 要傳回的範例錯誤報告數量。如未指定，則會使用 0。注意：目前僅支援 0 和 1。

要求主體

要求主體必須為空白。

回應主體

回應，其中包含符合要求的分頁問題清單。

如果成功，回應主體會含有以下結構的資料：

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

object (ErrorIssue)

發現錯誤問題。
nextPageToken

string

用於擷取下一頁資料的接續符記。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。