gplay reviews history

Read the full review history for --package from Google's monthly CSV reports in the developer's Reporting bucket — the only channel beyond reviews list's 7-day API window (ADR-0037).

The report is read from the Reporting bucket over the Cloud Storage API with a distinct read-only scope (devstorage.read_only); the service account needs the "View app information" (global) permission. The bucket name defaults to pubsite_prod_rev_<developerId> from the developer-account axis; override it with --bucket when the Console-issued URI differs (copy it with the Console's "Copy Cloud Storage URI" button).

--month YYYY-MM selects one month; when omitted, the latest month present for the package is used. --from YYYY-MM --to YYYY-MM instead read every monthly report across the range and merge them into one result set (a review edited across the month boundary appears once, latest update winning; a month with no report is skipped with a WARN). --month and --from/--to are mutually exclusive. Default table columns: date, stars, locale, version, title, summary — override with --columns device,reply,...

--output json emits the parsed rows as {"reviews":[...]} with stable lowerCamel field names (the documented ADR-0037 deviation: the upstream is a CSV file, not a JSON API response); --output markdown renders a Markdown table.

[experimental] — the surface may still evolve (ADR-0010).

Usage

  gplay reviews history [flags]

Flags

Flag	Description
--bucket string	Reporting bucket name override (default: pubsite_prod_rev_<developerId>)
--columns string	comma-separated table columns to show (default: date,stars,locale,version,title,summary)
--developer-id string	Play Console Developer account id used to derive the bucket (overrides the active Account's, env, and project-local)
--from string	range start as YYYY-MM (with --to; mutually exclusive with --month)
--month string	month to read as YYYY-MM (default: the latest month present in the bucket)
--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)
--to string	range end as YYYY-MM (with --from; mutually exclusive with --month)

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)