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: リクエストされたタイプのエラー問題のみと一致します。有効な受験者: CRASHANR。例: 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 つのフィールドのみがサポートされています。

リクエスト本文

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

レスポンスの本文

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

成功すると、レスポンスの本文に次の構造のデータが含まれます。

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

object (ErrorIssue)

検出された ErrorIssues。

nextPageToken

string

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

認可スコープ

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

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

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