Method: vitals.errors.issues.search

レポートがグループ化されているすべてのエラー問題を検索します。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
parent

string

必須。エラー問題の親リソース。エラー問題を受信したアプリケーションを示します。

形式: apps/{app}

クエリ パラメータ

パラメータ
interval

object (DateTimeInterval)

省略可。エラー問題を検索する日時間隔。開始と終了は時間単位で揃え、タイムゾーンとして UTC を使用する必要があります(空の場合も UTC が使用されます)。

設定すると、その間隔で発生した関連エラーレポートを含むエラー問題のみが返されます。指定しない場合は、デフォルトの間隔(過去 24 時間)が使用されます。

pageSize

integer

省略可。返されるエラー問題の最大数。サービスから返される数は、この値より少ない場合があります。

指定されていない場合は、最大で 50 件のエラー問題が返されます。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。

pageToken

string

省略可。前回の呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページ分割を行う場合、リクエストに指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。

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
  • appProcessState: アプリのプロセス状態のエラー問題に一致します。アプリがフォアグラウンド(ユーザーに表示される)で実行されているか、バックグラウンドで実行されているかを示します。有効な候補: FOREGROUNDBACKGROUND。 例: appProcessState = FOREGROUND
  • isUserPerceived: ユーザーが認識したエラー問題に一致します。演算子は使用しません。例: isUserPerceived

** サポートされている演算子:**

  • 比較演算子: サポートされている比較演算子は等号のみです。 フィルタリングされたフィールドは、比較の左側に表示する必要があります。
  • 論理演算子: 論理演算子 ANDOR を使用して、連言標準形(CNF)、つまり選言の連言に従って複雑なフィルタを作成できます。OR 演算子は AND よりも優先されるため、CNF を作成するときに括弧を使用する必要はありません。

OR 演算子は、同じフィールドに適用される選言を作成する場合にのみサポートされます。たとえば、versionCode = 123 OR errorIssueType = ANR は有効なフィルタではありません。

** 例 **

有効なフィルタリング式: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

orderBy

string

省略可。結果の並べ替えに使用するフィールドを指定します。

** サポートされているディメンション:**

  • errorReportCount: エラーレポートの数で問題を並べ替えます。
  • distinctUsers: 影響を受けた一意のユーザー数で問題を並べ替えます。

** サポートされているオペレーション:**

  • asc: 昇順。
  • desc: 降順。

形式: フィールドとオペレーション(例: errorReportCount desc

注:現在、一度に 1 つのフィールドのみがサポートされています。

sampleErrorReportLimit

integer

省略可。ErrorIssue ごとに返されるサンプル エラーレポートの数。指定しない場合は 0 が使用されます。注:現在、0 と 1 のみがサポートされています。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

リクエストに一致した問題のページ分割されたリストを含むレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "errorIssues": [
    {
      object (ErrorIssue)
    }
  ],
  "nextPageToken": string
}
フィールド
errorIssues[]

object (ErrorIssue)

検出された ErrorIssue。

nextPageToken

string

データの次のページを取得するための継続トークン。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/playdeveloperreporting

詳細については、OAuth 2.0 Overview をご覧ください。