Skip to content

gplay metadata validate

Lint the Metadata tree under --dir without contacting Google Play: checks character limits (title 30, short description 80, full description 4000), required non-empty fields (title and full description — an empty file is a validation error, not a clear), and that every locale directory names a known Play store locale.

This command is OFFLINE — it needs no credentials and makes no network call, so it is safe in a pre-commit hook or a CI gate. Diffing the tree against what is live on Play is the job of gplay metadata apply --dry-run.

A locale Google added after this gplay release can be whitelisted with --allow-locale xx-YY (repeatable). Any violation exits 20.

gplay metadata validate [flags]
FlagDescription
--allow-locale stringArraywhitelist a locale code not in gplay's embedded Play-locale list (repeatable)
--dir stringpath to the metadata tree to lint (default "./metadata")
--output stringoutput format: table, json, or markdown (default: auto — table on TTY, json in pipes/CI)
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)