Method: vitals.stuckbackgroundwakelockrate.query

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
name

string

必須。リソース名。

形式: apps/{app}/stuckBackgroundWakelockRateMetricSet

リクエストの本文

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

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

object (TimelineSpec)

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

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

  • DAILY: 指標はカレンダーの日付間隔で集計されます。過去の制約により、サポートされているタイムゾーンは America/Los_Angeles のみです。
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

省略可。集計する指標。

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

  • stuckBgWakelockRate（google.type.Decimal）: 集計期間中にバックグラウンドで 1 時間以上ウェイクロックが保持された一意のユーザーの割合。
  • stuckBgWakelockRate7dUserWeighted（google.type.Decimal）: 過去 7 日間の stuckBgWakelockRate の移動平均値。1 日の値は、その日のユニーク ユーザー数で重み付けされます。
  • stuckBgWakelockRate28dUserWeighted（google.type.Decimal）: 過去 28 日間の stuckBgWakelockRate の移動平均値。1 日の値は、その日のユニーク ユーザー数で重み付けされます。
  • distinctUsers（google.type.Decimal）: stuckBgWakelockRate 指標の正規化値として使用された集計期間内の個別のユーザー数。この指標では、アプリがデバイスで何らかの処理を行っていた場合（フォアグラウンドでのアクティブな使用だけでなく、バックグラウンドでの処理も含む）に、ユーザーがカウントされます。このカウントをさらに集計すると、ユーザーが複数回カウントされる可能性があるため、注意が必要です。値の大きさによって、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 のみです。

レスポンスの本文

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

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

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

object (MetricsRow)

返されたデータ行。
nextPageToken

string

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

認可スコープ

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

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

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