Method: vitals.errors.reports.search

アプリで受信したすべてのエラー レポートを検索します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。レポートの親リソース。レポートが受信されたアプリケーションを示します。

形式: apps/{app}

クエリ パラメータ

パラメータ
interval

object (DateTimeInterval)

エラー レポートを検索する日時間隔。開始と終了の両方を時間単位で調整し、タイムゾーンとして UTC を使用する必要があります（または空にすることもできます。その場合も UTC が使用されます）。

設定すると、その期間に発生したエラーレポートのみが返されます。指定しない場合、デフォルトの 24 時間間隔が使用されます。
pageSize

integer

返すレポートの最大数。サービスが返す値はこれよりも少ないことがあります。

指定されていない場合、最大で 50 件のレポートが返されます。最大値は 100 です。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 をご覧ください。