gplay expansion

gplay expansion

Manage expansion files (OBB files).

gplay expansion <subcommand> [flags]

Manage expansion files (OBB) for large assets.

Expansion files are used to deliver large assets (up to 2GB each) that don’t fit within the APK size limit.

File types:

• main: Required, primary expansion file
• patch: Optional, update to the main file

Note: For new apps, consider using Play Asset Delivery instead, which provides a better user experience.

gplay expansion get

Get expansion file information.

gplay expansion get --package <name> --edit <id> --apk-version <code> --type <type>

Flag	Description	Default
--apk-version	APK version code	0
--edit	Edit ID	``
--output	Output format: json (default), table, markdown	json
--package	Package name (applicationId)	``
--pretty	Pretty-print JSON output	false
--type	Expansion file type: main (default), patch	main

gplay expansion upload

Upload an expansion file.

gplay expansion upload --package <name> --edit <id> --apk-version <code> --type <type> --file <path>

Flag	Description	Default
--apk-version	APK version code	0
--edit	Edit ID	``
--file	Path to .obb file	``
--output	Output format: json (default), table, markdown	json
--package	Package name (applicationId)	``
--pretty	Pretty-print JSON output	false
--type	Expansion file type: main (default), patch	main

gplay expansion patch

Reference an expansion file from another APK version.

gplay expansion patch --package <name> --edit <id> --apk-version <code> --type <type> --references-version <code>

Reference an expansion file from a different APK version.

This allows you to reuse an existing expansion file for a new APK without re-uploading it.

Flag	Description	Default
--apk-version	APK version code	0
--edit	Edit ID	``
--output	Output format: json (default), table, markdown	json
--package	Package name (applicationId)	``
--pretty	Pretty-print JSON output	false
--references-version	APK version code that contains the file to reference	0
--type	Expansion file type: main (default), patch	main

gplay expansion update

Update expansion file metadata.

gplay expansion update --package <name> --edit <id> --apk-version <code> --type <type> --references-version <code>

Update expansion file metadata using edits.expansionfiles.update.

Use this to replace the expansion file reference for an APK version with a reference to an expansion file from another APK version.

Flag	Description	Default
--apk-version	APK version code	0
--edit	Edit ID	``
--output	Output format: json (default), table, markdown	json
--package	Package name (applicationId)	``
--pretty	Pretty-print JSON output	false
--references-version	APK version code that contains the file to reference	0
--type	Expansion file type: main (default), patch	main