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：只比對要求類型的錯誤報告。有效候選人：CRASH、ANR、NON_FATAL。 例如：errorIssueType = CRASH OR errorIssueType = ANR。
  • errorIssueId：只比對屬於所要求錯誤問題 ID 的錯誤報告。範例：errorIssueId = 1234 OR errorIssueId = 4567。
  • errorReportId：比對錯誤報告與要求的錯誤報告 ID。範例：errorReportId = 1234 OR errorReportId = 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 Overview。