Skip to content

gplay auth doctor

Run the doctor sequence from docs/DESIGN.md §1:

  1. Service account JSON is valid
  2. OAuth2 access token can be minted
  3. Token carries the androidpublisher scope
  4. (Per --package) edits.insert + edits.delete round-trip on the package

Checks 1–3 run once. Check 4 runs once per --package value passed (in order). Checks run in order and the chain stops on the first failure; subsequent checks are reported as skipped. Use --output json to get a structured []CheckResult for scripting.

gplay auth doctor [flags]
FlagDescription
--output stringoutput format: table, json, or markdown (default: auto — table on TTY, json in pipes/CI)
--package stringsAndroid package name to round-trip an edits.insert+delete against; repeat for multiple packages
FlagDescription
--account stringname of a stored Account to use (overrides env and active Account)
--retry intretry transient failures (transport errors, 5xx, 429) up to N times with exponential backoff (default: 0, no retry)
--service-account stringpath to a service-account JSON, or inline JSON content (overrides --account, env, and active Account)
--timeout durationper-request API timeout, e.g. 30s or 2m (default: 60s for control-plane calls, none for uploads)
-v, --verboselog flow steps to stderr (info level)