$gpc device-tiers
--json--dry-run
Manage device tier configurations for capability-based targeting.
usage
gpc device-tiers <subcommand> [options]Commands
| Command | Description |
|---|---|
device-tiers list | List all device tier configurations |
device-tiers get | Get details of a specific tier configuration |
device-tiers create | Create a new device tier configuration |
device-tiers list
List all device tier configurations for the app.
Synopsis
bash
gpc device-tiers list [options]1
Options
| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--app | string | App package name | ||
--limit | number | 25 | Maximum number of results | |
--json | flag | Output as JSON |
Example
List all tier configs:
bash
gpc device-tiers list --app com.example.myapp1
Device Tier Configurations
Config ID Groups Created
───────── ────── ───────
dt-config-1 3 2025-11-02
dt-config-2 2 2026-01-15
2 configurations found1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
List with JSON output:
bash
gpc device-tiers list --app com.example.myapp --json1
json
{
"deviceTierConfigs": [
{
"deviceTierConfigId": "dt-config-1",
"deviceGroups": [
{
"name": "high_end",
"deviceSelectors": [{ "deviceRam": { "minBytes": "6442450944" } }]
},
{
"name": "mid_range",
"deviceSelectors": [
{ "deviceRam": { "minBytes": "3221225472", "maxBytes": "6442450943" } }
]
},
{
"name": "low_end",
"deviceSelectors": [{ "deviceRam": { "maxBytes": "3221225471" } }]
}
]
}
]
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
device-tiers get
Get the full details of a specific device tier configuration, including all device groups and their selectors.
Synopsis
bash
gpc device-tiers get <config-id> [options]1
Options
| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--app | string | App package name | ||
--json | flag | Output as JSON |
Example
bash
gpc device-tiers get dt-config-1 --app com.example.myapp1
Device Tier Configuration: dt-config-1
Group: high_end
RAM >= 6 GB
Group: mid_range
RAM >= 3 GB, < 6 GB
Group: low_end
RAM < 3 GB1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
device-tiers create
Create a new device tier configuration from a JSON file. The file defines device groups with selectors based on RAM, SoC, or other device properties.
Synopsis
bash
gpc device-tiers create --file <path> [options]1
Options
| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--file | -f | string | (required) | Path to JSON config file |
--app | string | App package name | ||
--json | flag | Output as JSON |
Example
Create a configuration file (tiers.json):
json
{
"deviceGroups": [
{
"name": "premium",
"deviceSelectors": [
{
"deviceRam": { "minBytes": "8589934592" },
"includedSystemOnChips": [{ "make": "Qualcomm", "model": "SM8550" }]
}
]
},
{
"name": "standard",
"deviceSelectors": [
{
"deviceRam": { "minBytes": "4294967296", "maxBytes": "8589934591" }
}
]
},
{
"name": "lite",
"deviceSelectors": [
{
"deviceRam": { "maxBytes": "4294967295" }
}
]
}
]
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
Then create the tier configuration:
bash
gpc device-tiers create --file tiers.json --app com.example.myapp1
Created device tier configuration: dt-config-3
3 device groups defined (premium, standard, lite)1
2
2
Errors
| Code | Exit | Description |
|---|---|---|
DEVICE_TIER_CONFIG_NOT_FOUND | 4 | The specified config ID does not exist for this app |
INVALID_DEVICE_TIER_CONFIG | 2 | The JSON file is missing required fields or has invalid selectors |
API_ERROR | 4 | Google Play API rejected the request |
Related
- generated-apks -- Download APKs generated for specific device tiers
- releases -- Manage releases and track assignments