Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
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: リクエストされたタイプのエラーレポートのみに一致します。 有効な候補: CRASH、ANR、NON_FATAL。 例: errorIssueType = CRASH OR errorIssueType = ANR。
errorIssueId: リクエストされたエラー問題 ID に属するエラーレポートのみに一致します。例: errorIssueId = 1234 OR errorIssueId = 4567。
errorReportId: リクエストされたエラーレポート ID のエラーレポートに一致します。例: errorReportId = 1234 OR errorReportId = 4567。
appProcessState: アプリのプロセス状態に関するエラーレポートに一致します。アプリがフォアグラウンド(ユーザーに表示される)で実行されているか、バックグラウンドで実行されているかを示します。有効な候補: FOREGROUND、BACKGROUND。 例: appProcessState = FOREGROUND。
isUserPerceived: ユーザーが認識したエラーレポートに一致します。演算子は使用しません。例: isUserPerceived。
** サポートされている演算子:**
- 比較演算子: サポートされている比較演算子は等価のみです。 フィルタリングされたフィールドは、比較の左側に表示する必要があります。
- 論理演算子: 論理演算子
AND と OR を使用して、連言標準形(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 をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2026-04-22 UTC。
[null,null,["最終更新日 2026-04-22 UTC。"],[],["This outlines how to search for app error reports via an HTTP GET request to `https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/errorReports:search`. The `parent` path parameter specifies the app. Query parameters include `interval` for date ranges, `pageSize` for report limits (max 100), `pageToken` for pagination, and `filter` for narrowing results by criteria like `apiLevel`, `versionCode`, or `errorIssueType`. The request body is empty, and the response body contains a paginated list of `errorReports` and a `nextPageToken`.\n"]]