Skip to content

gplay metadata pull

Rapatriate the Store front Listings currently live on Google Play for --package into the local Metadata tree under --dir (default ./metadata): one <locale>/<field>.txt file per managed field a locale holds non-empty online (title, short_description, full_description, video).

Reads the Listings inside a read-only Edit (open → listings.list → discard); nothing is committed. The write is additive — a field Play holds empty writes no file, and a local locale absent online is left intact. Removing locales/fields no longer online is the opt-in job of gplay metadata apply --prune.

Because pull writes only non-empty online values and the tree codec is a value-level inverse, a metadata apply immediately after a pull is a guaranteed no-op (ADR-0011).

gplay metadata pull [flags]
FlagDescription
--dir stringdirectory to write the Metadata tree into (default "./metadata")
--output stringoutput format: table, json, or markdown (default: auto — table on TTY, json in pipes/CI)
--package stringAndroid package name (overrides .gplay/config.json pin)
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)