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: リクエストされたタイプのエラーレポートのみと一致します。有効な受験者: 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 の概要をご覧ください。