gplay images
gplay images
Section titled “gplay images”Manage listing images and Play media sync.
gplay images <subcommand> [flags]Manage listing images within an edit and sync Play store media.
Valid –type values: phoneScreenshots Phone screenshots (min 2, max 8) sevenInchScreenshots 7-inch tablet screenshots tenInchScreenshots 10-inch tablet screenshots tvScreenshots Android TV screenshots wearScreenshots Wear OS screenshots icon App icon (512x512 PNG) featureGraphic Feature graphic (1024x500) tvBanner TV banner (1280x720) promoGraphic Promotional graphic
Images must be PNG or JPEG. Max file size: 15MB.
gplay images list
Section titled “gplay images list”List images for a listing.
gplay images list --package <name> --edit <id> --locale <lang> --type <type>| Flag | Description | Default |
|---|---|---|
--edit |
Edit ID | `` |
--locale |
Locale (e.g. en-US) | `` |
--output |
Output format: json (default), table, markdown | json |
--package |
Package name (applicationId) | `` |
--pretty |
Pretty-print JSON output | false |
--type |
Image type (phoneScreenshots, featureGraphic, etc) | `` |
gplay images upload
Section titled “gplay images upload”Upload an image to a listing.
gplay images upload --package <name> --edit <id> --locale <lang> --type <type> --file <path>Upload an image to a store listing.
Supported formats: PNG, JPEG, WebP, GIF. Max file size: 15MB. The image type determines size and count constraints (see gplay images –help).
Examples: gplay images upload –package com.example –edit EDIT_ID –locale en-US –type phoneScreenshots –file screenshot1.png gplay images upload –package com.example –edit EDIT_ID –locale en-US –type featureGraphic –file feature.png
| Flag | Description | Default |
|---|---|---|
--edit |
Edit ID | `` |
--file |
Path to image file | `` |
--locale |
Locale (e.g. en-US) | `` |
--output |
Output format: json (default), table, markdown | json |
--package |
Package name (applicationId) | `` |
--pretty |
Pretty-print JSON output | false |
--type |
Image type (phoneScreenshots, featureGraphic, etc) | `` |
gplay images delete
Section titled “gplay images delete”Delete an image from a listing.
gplay images delete --package <name> --edit <id> --locale <lang> --type <type> --image <id> --confirm| Flag | Description | Default |
|---|---|---|
--confirm |
Confirm delete | false |
--edit |
Edit ID | `` |
--image |
Image ID | `` |
--locale |
Locale (e.g. en-US) | `` |
--output |
Output format: json (default), table, markdown | json |
--package |
Package name (applicationId) | `` |
--pretty |
Pretty-print JSON output | false |
--type |
Image type | `` |
gplay images delete-all
Section titled “gplay images delete-all”Delete all images for a listing.
gplay images delete-all --package <name> --edit <id> --locale <lang> --type <type> --confirm| Flag | Description | Default |
|---|---|---|
--confirm |
Confirm delete | false |
--edit |
Edit ID | `` |
--locale |
Locale (e.g. en-US) | `` |
--output |
Output format: json (default), table, markdown | json |
--package |
Package name (applicationId) | `` |
--pretty |
Pretty-print JSON output | false |
--type |
Image type | `` |
gplay images plan
Section titled “gplay images plan”Plan deterministic Play media sync operations.
gplay images plan --package <name> --edit <id> [--dir <path>] [--locale <lang>]Compare local Play media files against the current edit state.
Local directory layout: <dir>/<locale>/images/ phoneScreenshots/ sevenInchScreenshots/ tenInchScreenshots/ tvScreenshots/ wearScreenshots/ featureGraphic.png icon.png promoGraphic.png tvBanner.png
The plan is based on SHA-256 hashes and does not mutate remote state.
| Flag | Description | Default |
|---|---|---|
--dir |
Directory containing Play media files | ./metadata |
--edit |
Edit ID | `` |
--locale |
Specific locale to sync (optional) | `` |
--output |
Output format: json (default), table, markdown | json |
--package |
Package name (applicationId) | `` |
--pretty |
Pretty-print JSON output | false |
gplay images pull
Section titled “gplay images pull”Pull remote Play media into the local directory layout.
gplay images pull --package <name> --edit <id> [--dir <path>] [--locale <lang>]Download the current edit’s media into the local Play directory layout.
Screenshot files are saved as deterministic numbered files under each device type directory. Single-image assets are saved by their conventional names.
| Flag | Description | Default |
|---|---|---|
--dir |
Directory containing Play media files | ./metadata |
--edit |
Edit ID | `` |
--locale |
Specific locale to sync (optional) | `` |
--output |
Output format: json (default), table, markdown | json |
--package |
Package name (applicationId) | `` |
--pretty |
Pretty-print JSON output | false |
gplay images sync
Section titled “gplay images sync”Upload local Play media to the current edit.
gplay images sync --package <name> --edit <id> [--dir <path>] [--locale <lang>]Upload local Play media using the deterministic local directory layout.
The command compares local files to remote SHA-256 hashes and only uploads
assets that are missing or changed. Use --dry-run for a transport-level
preview of the upload calls.
| Flag | Description | Default |
|---|---|---|
--dir |
Directory containing Play media files | ./metadata |
--edit |
Edit ID | `` |
--locale |
Specific locale to sync (optional) | `` |
--output |
Output format: json (default), table, markdown | json |
--package |
Package name (applicationId) | `` |
--pretty |
Pretty-print JSON output | false |