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: リクエストされたタイプのエラーレポートのみに一致します。 有効な候補: CRASHANRNON_FATAL。 例: errorIssueType = CRASH OR errorIssueType = ANR
  • errorIssueId: リクエストされたエラー問題 ID に属するエラーレポートのみに一致します。例: errorIssueId = 1234 OR errorIssueId = 4567
  • errorReportId: リクエストされたエラーレポート ID のエラーレポートに一致します。例: errorReportId = 1234 OR errorReportId = 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 Overview をご覧ください。