gplay metadata
gplay metadata
Section titled “gplay metadata”File-based metadata sync (pull/push/validate).
gplay metadata <subcommand> [flags]Pull, push, and validate store listing metadata as local files.
The metadata directory uses a flat structure with one directory per locale: metadata/ en-US/ title.txt short_description.txt full_description.txt video_url.txt ja-JP/ title.txt …
Use ‘gplay metadata pull’ to download current listings to files. Use ‘gplay metadata push’ to upload file changes to the store. Use ‘gplay metadata validate’ to check metadata locally before pushing.
gplay metadata pull
Section titled “gplay metadata pull”Pull store listing metadata into local files.
gplay metadata pull --package <name> --dir <path> [--locales en-US,ja-JP]Pull store listing metadata from Google Play into local files.
Creates a directory structure with one folder per locale: metadata/ en-US/ title.txt short_description.txt full_description.txt video_url.txt (if present) ja-JP/ …
Examples: gplay metadata pull –package com.example –dir ./metadata gplay metadata pull –package com.example –dir ./metadata –locales en-US,ja-JP
| Flag | Description | Default |
|---|---|---|
--dir |
Output directory for metadata files (required) | `` |
--locales |
Comma-separated list of locales to pull (optional, pulls all if omitted) | `` |
--output |
Output format: json (default), table, markdown | json |
--package |
Package name (applicationId) | `` |
--pretty |
Pretty-print JSON output | false |
gplay metadata push
Section titled “gplay metadata push”Push local metadata files to Google Play.
gplay metadata push --package <name> --dir <path> [--locales en-US] [--confirm] [--dry-run]Push store listing metadata from local files to Google Play.
Reads files from the metadata directory and updates listings for each locale. Creates an edit, updates each listing, and commits the edit.
Requires –confirm for safety. Use –dry-run to preview changes.
Examples: gplay metadata push –package com.example –dir ./metadata –confirm gplay metadata push –package com.example –dir ./metadata –dry-run gplay metadata push –package com.example –dir ./metadata –locales en-US –confirm
| Flag | Description | Default |
|---|---|---|
--confirm |
Confirm push (required for safety) | false |
--dir |
Metadata directory to read from (required) | `` |
--dry-run |
Show what would be updated without calling API | false |
--locales |
Comma-separated list of locales to push (optional, pushes all if omitted) | `` |
--output |
Output format: json (default), table, markdown | json |
--package |
Package name (applicationId) | `` |
--pretty |
Pretty-print JSON output | false |
gplay metadata validate
Section titled “gplay metadata validate”Validate metadata files offline.
gplay metadata validate --dir <path>Validate local metadata files against Google Play character limits.
Checks:
- title.txt: max 30 characters
- short_description.txt: max 80 characters
- full_description.txt: max 4000 characters
Reports errors per locale per field. Exits non-zero if validation errors found.
Examples: gplay metadata validate –dir ./metadata
| Flag | Description | Default |
|---|---|---|
--dir |
Metadata directory to validate (required) | `` |
--output |
Output format: json (default), table, markdown | json |
--pretty |
Pretty-print JSON output | false |