Method: vitals.crashrate.query

指標セットの指標をクエリします。

HTTP リクエスト

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/crashRateMetricSet}:query

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

パスパラメータ

パラメータ
name

string

必須。リソース名。

形式: apps/{app}/crashRateMetricSet

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
フィールド
timelineSpec

object (TimelineSpec)

省略可。タイムライン集計パラメータの仕様。

サポートされている集計期間:

  • DAILY: 指標はカレンダーの日付間隔で集計されます。過去の制約により、デフォルトでサポートされているタイムゾーンは America/Los_Angeles のみです。
  • HOURLY: 指標は 1 時間間隔で集計されます。デフォルトでサポートされているタイムゾーンは UTC のみです。
dimensions[]

string

省略可。指標を分割するディメンション。

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

  • apiLevel（string）: ユーザーのデバイスで実行されていた Android の API レベル（例: 26）。
  • versionCode（int64）: ユーザーのデバイスで実行されていたアプリのバージョン。
  • deviceModel（string）: ユーザーのデバイスモデルの一意の識別子。識別子の形式は「deviceBrand/device」です。deviceBrand は Build.BRAND に対応し、device は Build.DEVICE に対応します（例: google/coral）。
  • deviceBrand（string）: ユーザーのデバイスのブランドの一意の識別子（例: google）。
  • deviceType（string）: ユーザーのデバイスの種類（フォーム ファクタとも呼ばれます）（例: PHONE）。
  • countryCode（string）: ユーザーの IP アドレスに基づくデバイスの国または地域。2 文字の ISO-3166 コードで表されます（例: 米国の場合は US）。
  • deviceRamBucket（int64）: デバイスの RAM（MB 単位）。バケット（3 GB、4 GB など）で表されます。
  • deviceSocMake（string）: デバイスのメイン システムオンチップのメーカー（例: Samsung）。リファレンス
  • deviceSocModel（string）: デバイスのメイン システムオンチップのモデル（例: Exynos 2100）。リファレンス
  • deviceCpuMake（string）: デバイスの CPU のメーカー（例: Qualcomm）。
  • deviceCpuModel（string）: デバイスの CPU のモデル（例: Kryo 240）。
  • deviceGpuMake（string）: デバイスの GPU のメーカー（例: ARM）。
  • deviceGpuModel（string）: デバイスの GPU のモデル（例: Mali）。
  • deviceGpuVersion（string）: デバイスの GPU のバージョン（例: T750）。
  • deviceVulkanVersion（string）: デバイスの Vulkan バージョン（例: 4198400）。
  • deviceGlEsVersion（string）: デバイスの OpenGL ES バージョン（例: 196610）。
  • deviceScreenSize（string）: デバイスの画面サイズ（例: NORMAL、LARGE）。
  • deviceScreenDpi（string）: デバイスの画面密度（例: mdpi、hdpi）。
metrics[]

string

省略可。集計する指標。

サポートされている指標:

  • crashRate（google.type.Decimal）: 集計期間中に少なくとも 1 回クラッシュが発生したユニーク ユーザーの割合。
  • crashRate7dUserWeighted（google.type.Decimal）: 過去 7 日間の crashRate の移動平均値。1 日の値は、その日のユニーク ユーザー数で重み付けされます。
  • crashRate28dUserWeighted（google.type.Decimal）: 過去 28 日間の crashRate の移動平均値。1 日の値は、その日のユニーク ユーザー数で重み付けされます。HOURLY の粒度では対象外です。
  • userPerceivedCrashRate（google.type.Decimal）: アプリのアクティブな使用中に少なくとも 1 回クラッシュ（ユーザーが認識したクラッシュ）が発生した、集計期間内のユニーク ユーザーの割合。アプリは、アクティビティを表示しているかフォアグラウンド サービスを実行しているときに、アクティブに使用されているとみなされます。
  • userPerceivedCrashRate7dUserWeighted（google.type.Decimal）: 過去 7 日間の userPerceivedCrashRate の移動平均値。1 日の値は、その日のユニーク ユーザー数で重み付けされます。HOURLY の粒度では対象外です。
  • userPerceivedCrashRate28dUserWeighted（google.type.Decimal）: 過去 28 日間の userPerceivedCrashRate の移動平均値。1 日の値は、その日のユニーク ユーザー数で重み付けされます。HOURLY の粒度では対象外です。
  • distinctUsers（google.type.Decimal）: 集計期間内のユニーク ユーザー数。crashRate 指標と userPerceivedCrashRate 指標の正規化値として使用されます。集計期間中にアプリを積極的に使用したユーザーは、この指標でカウントされます。アプリは、アクティビティを表示しているかフォアグラウンド サービスを実行しているときに、アクティブに使用されているとみなされます。この数をさらに集計すると、ユーザーが複数回カウントされる可能性があるため、注意が必要です。値の大きさに応じて、10、100、1,000、1,000,000 の最も近い倍数に丸められます。
filter

string

省略可。データに適用するフィルタ。フィルタリング式は AIP-160 標準に準拠しており、すべてのブレークダウン ディメンションの等価性によるフィルタリングをサポートしています。
pageSize

integer

省略可。返されるデータの最大サイズ。

指定しない場合、最大 1, 000 行が返されます。最大値は 100,000 です。100,000 を超える値は 100,000 に強制変換されます。
pageToken

string

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

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

enum (UserCohort)

省略可。選択するユーザー ビュー。出力データは、選択したビューに対応します。

サポートされている値:

  • OS_PUBLIC: 公開されているすべての Android バージョンのデータを選択します。この設定がデフォルトです。上記のすべてのディメンションをサポートしています。
  • APP_TESTERS: テスターになることを選択したユーザーのデータを選択します。上記のすべてのディメンションをサポートしています。
  • OS_BETA: リリースされた Android バージョンのデータを除き、ベータ版の Android バージョンのデータのみを選択します。次のディメンションのみがサポートされています。

  • versionCode（int64）: ユーザーのデバイスで実行されていたアプリのバージョン。

  • osBuild（string）: ユーザーのデバイスの OS ビルド（例: T1B2.220916.004）。

レスポンスの本文

crashrate.query に対するレスポンス メッセージです。

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

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

object (MetricsRow)

返されたデータ行。
nextPageToken

string

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

認可スコープ

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

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

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