Method: vitals.errors.reports.search

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

HTTP リクエスト

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{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 をご覧ください。