catalog-management
Installation
SKILL.md
Catalog Management
Manage Google Play product catalogs at scale through the Android Publisher API. This skill helps you choose between Play Console and API based workflows, wire up the right endpoints for one time products and subscriptions, and keep regional pricing in sync with your source of truth.
Phase 1: Discovery
Confirm the basics before writing catalog code.
- Service account scope. The service account attached to your Google Play project must hold the Financial permission (or the legacy equivalent) on the Google Play Console. Without it,
inappproducts,monetization.onetimeproducts, andmonetization.subscriptionscalls return 403. Verify in Play Console under Users and permissions, then grant app level access to every package you intend to manage. - API product surface. Identify which endpoint family each SKU currently lives under. Products created before the one time product model upgrade live under
inappproducts. Products created through the new service live undermonetization.onetimeproducts. Once migrated, the legacy surface stops serving that product. - Existing catalog shape. List the current catalog with
monetization.onetimeproducts.listandmonetization.subscriptions.list. Record product IDs, base plan IDs, offer IDs, and activation state so you know what you are mutating. - Quota posture. Review quota usage in the Google Cloud Console under APIs and Services > Quotas for the Google Play Android Developer API. The three tiers you depend on are the per minute query limit, the hourly modification limit, and the hourly latency sensitive modification limit.
Phase 2: Plan
Choose the management model that matches your scale.