Method: vitals.bitmapmemoryusage.query

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

HTTP リクエスト

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/bitmapMemoryUsageMetricSet}:query

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

パスパラメータ

パラメータ
name

string

必須。リソース名。

Format: apps/{app}/bitmapMemoryUsageMetricSet

リクエストの本文

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

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）。
  • processName（string）: 実行されていたプロセスの名前（例: com.example.app）。
  • appState（string）: メモリが収集されたときのアプリの状態（例: FOREGROUND）。
metrics[]

string

省略可。集計する指標。

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

  • bitmapMemoryUsageP50（google.type.Decimal）: ビットマップ メモリ使用量の 50 パーセンタイル値。
  • bitmapMemoryUsageP75（google.type.Decimal）: ビットマップ メモリ使用量の 75 パーセンタイル値。
  • bitmapMemoryUsageP90（google.type.Decimal）: ビットマップ メモリ使用量の 90 パーセンタイル値。
  • bitmapMemoryUsageP95（google.type.Decimal）: ビットマップ メモリ使用量の 95 パーセンタイル値。
  • bitmapMemoryUsageP99（google.type.Decimal）: ビットマップ メモリ使用量の 99 パーセンタイル値。
  • distinctUsers（google.type.Decimal）: 集計期間中にメモリ指標が報告された個別のユーザー数。この数をさらに集計すると、ユーザーが複数回カウントされる可能性があるため、注意が必要です。値の大きさに応じて、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 のみです。

レスポンスの本文

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

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

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

object (MetricsRow)

返されたデータの行。
nextPageToken

string

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

認可スコープ

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

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

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