gplay-appstorelisted
Install: claude install-skill PollyGlot/google-play-cli-skills
# gplay appstore (alternative app store operations)
`gplay appstore` acts for the **operator of a third-party Android app store**:
the catalog that store mirrors from Play, and the apps it hosts and must send to
Google for review. Publishing your own app to Google Play is `gplay-release-flow`.
Shared conventions are in `gplay-cli-usage`. Read the current flags from
`gplay appstore <command> --help`, which is complete.
## Caller and subject: two packages, one command
| Flag | Role | Falls back to |
|---|---|---|
| `--store-package` | the **caller**, your app store's own package | `$GPLAY_APP_STORE_PACKAGE` (ADR-0043) |
| `--package` | the **subject**, the hosted app acted on | the repo's `.gplay/config.json` pin |
Swapping the two is the standard failure here. The catalog reads take the
**caller** only, and address the Play app as a positional argument: they ignore
the repo pin, so a resolved `.gplay/config.json` still leaves `--store-package`
required.
## Mirror Play's catalog
```bash
gplay appstore catalog view com.example.app --store-package com.mystore.app
gplay appstore catalog events list \
--since 2026-07-01T00:00:00Z --until 2026-07-08T00:00:00Z
```
`catalog events list` is the **incremental sync** feed, and the reason to script
this surface at all: each event is a `MODIFICATION` (re-fetch that app with
`catalog view`) or a `DELETION` (delist it). Persist each run's `--until` and
feed it back as the next run's `--since`.
## Take a hosted app through review