Method: vitals.stuckbackgroundwakelockrate.query

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

HTTP リクエスト

POST https://playdeveloperreporting.googleapis.com/v1beta1/{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）: ユーザーのデバイスモデルの一意の識別子。ID の形式は「deviceBrand/device」です。deviceBrand は Build.BRAND に、device は Build.DEVICE に対応しています（例: google/coral）。
  • deviceBrand（string）: ユーザーのデバイス ブランドの一意の識別子（例: google
  • deviceType（string）: ユーザーのデバイスの種類（フォーム ファクタとも呼ばれます）。スマートフォン。
  • 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 のモデル。例:マリ
  • 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一般公開されているすべての Android バージョンからデータを選択する場合。この設定がデフォルトです。上記のディメンションをすべてサポートします。
  • APP_TESTERS テスターとしてオプトインしたユーザーのデータを選択します。上記のディメンションをすべてサポートします。
  • OS_BETA ベータ版の Android バージョンからのみデータを選択する場合（リリース済みの Android バージョンのデータは除く）。次のディメンションのみがサポートされています。

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

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

レスポンスの本文

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

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

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

object (MetricsRow)

返されたデータ行。
nextPageToken

string

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

認可スコープ

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

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

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