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

** 支援的運算子:**

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