Method: vitals.errors.reports.search

搜尋應用程式收到的所有錯誤報告。

HTTP 要求

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

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

路徑參數

參數
parent

string

必要欄位。報表的父項資源，指出收到報表的應用程式。

格式：apps/{app}

查詢參數

參數
interval

object (DateTimeInterval)

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

如果設定此屬性，系統只會傳回在間隔期間發生的錯誤報告。如未指定，系統會使用過去 24 小時的預設間隔。
pageSize

integer

要傳回的報表數量上限。服務傳回的產品數量可能會少於這個值。

如未指定，最多將傳回 50 份報表。許可的最大值為 100；超出的數值將一律指定為 100。
pageToken

string

屬於接收自前一個 reports.search 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 reports.search 的所有其他參數須與提供網頁權杖的呼叫相符。
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：僅比對要求類型的錯誤報告。有效的候選項目：JAVA_CRASH、NATIVE_CRASH、ANR。範例：errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH。
  • errorIssueId：只比對所要求錯誤問題 ID 的錯誤報告。例如：errorIssueId = 1234 OR errorIssueId = 4567.
  • appProcessState：比對應用程式程序狀態的錯誤報告，指出應用程式是在前景 (使用者可以看見) 還是背景執行。有效的候選項目：FOREGROUND、BACKGROUND。範例：appProcessState = FOREGROUND。
  • isUserPerceived：比對使用者感知的錯誤報告。此屬性不會附帶任何運算子。例如：isUserPerceived.

** 支援的運算子：**

  • 比較運算子：系統僅支援「相等」比較運算子。經過篩選的欄位必須顯示在比較的左側。
  • 邏輯運算子：邏輯運算子 AND 和 OR 可用來建構符合正規化正規格式 (CNF) 的複雜篩選器，例如結合經紀元OR 運算子的優先順序高於 AND，因此建構 CNF 時不需要使用括號。

OR 運算子僅支援適用於相同欄位的假說，例如：跳到 versionCode = 123 OR versionCode = ANR 的位置。篩選運算式 versionCode = 123 OR errorIssueType = ANR 無效。

** 範例 **

一些有效的篩選運算式：* versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

要求主體

要求主體必須為空白。

回應主體

提供回應，列出與搜尋查詢相符的錯誤報告清單。

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

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

object (ErrorReport)

系統顯示的錯誤報告。
nextPageToken

string

用於擷取下一頁報表的網頁權杖。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。