Method: vitals.errors.issues.search

string

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

格式：apps/{app}

object (DateTimeInterval)

搜尋錯誤問題的日期時間間隔。開始時間和結束時間都必須以小時為單位，並使用 UTC 做為時區 (或留空，這樣也會使用 UTC)。

如果設定此參數，系統只會傳回間隔內發生的錯誤問題，以及相關的錯誤報告。如未指定，系統會使用過去 24 小時的預設間隔。

integer

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

如未指定，最多將傳回 50 個錯誤問題。許可的最大值為 1000；超出的數值將一律指定為 1000。

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。