Method: vitals.errors.issues.search

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

HTTP リクエスト

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{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: リクエストされたタイプのエラー問題のみを照合します。有効な候補: CRASH、ANR、NON_FATAL。（例: errorIssueType = CRASH OR errorIssueType = ANR）。
  • appProcessState: アプリのプロセス状態のエラー問題に一致します。アプリがフォアグラウンド（ユーザーに表示される）で実行されているか、バックグラウンドで実行されているかを示します。有効な候補: FOREGROUND、BACKGROUND。例: appProcessState = FOREGROUND
  • isUserPerceived: ユーザーが認識したエラーの問題を照合します。演算子は含まれません。例: isUserPerceived

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

  • 比較演算子: サポートされている比較演算子は等価演算子のみです。フィルタリングされたフィールドは、比較の左側に表示される必要があります。
  • 論理演算子: 論理演算子 AND と OR を使用して、連言標準形（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)

Error 見つかった問題。
nextPageToken

string

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

認可スコープ

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

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

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