gplay vitals query
Query one of the Play Developer Reporting metric sets directly — the generic, full-coverage form the opinionated presets (vitals crashes, vitals anr, …) wrap.
gplay vitals query crashrate --package com.example.app gplay vitals query crashrate --metrics crashRate,distinctUsers --dimensions versionCode gplay vitals query anrrate --period HOURLY --since 24h
--metrics and --dimensions are validated OFFLINE against the embedded API schema; unknown values are rejected with the valid set listed (names are never invented — they come from the snapshot). With no --metrics the set's primary metric is used. Default window: --since 28d, --period DAILY (HOURLY opt-in).
This is a READ-ONLY surface on a distinct Google service (Play Developer Reporting), requested with the least-privilege playdeveloperreporting scope.
--output json mirrors the API response verbatim; table/markdown render the timeline (dates × metrics, sliced by --dimensions). A freshness note is always printed to stderr so an empty window is not mistaken for zero.
gplay vitals query <metric-set> [flags]| Flag | Description |
|---|---|
--dimensions strings | dimensions to slice by (e.g. versionCode,countryCode); validated against the schema |
--metrics strings | metrics to aggregate (default: the set's primary metric); validated against the schema |
--output string | output format: table, json, or markdown (default: auto — table on TTY, json in pipes/CI) |
--package string | Android package name (overrides .gplay/config.json pin) |
--period string | aggregation period: DAILY, HOURLY, or FULL_RANGE (default "DAILY") |
--since string | window length back from now, e.g. 28d or 24h (default "28d") |
Global flags
Section titled “Global flags”| Flag | Description |
|---|---|
--account string | name of a stored Account to use (overrides env and active Account) |
--retry int | retry transient failures (transport errors, 5xx, 429) up to N times with exponential backoff (default: 0, no retry) |
--service-account string | path to a service-account JSON, or inline JSON content (overrides --account, env, and active Account) |
--timeout duration | per-request API timeout, e.g. 30s or 2m (default: 60s for control-plane calls, none for uploads) |
-v, --verbose | log flow steps to stderr (info level) |