gplay-iap-setup

Configure Google Play in-app products, subscriptions, base plans, and offers via the gplay CLI.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/lettucebo/Skills --skill gplay-iap-setup-lettucebo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gplay-iap-setup
Source: https://github.com/lettucebo/Skills/tree/main/skills/google-play-console-cli/gplay-iap-setup
Command: npx skills add https://github.com/lettucebo/Skills --skill gplay-iap-setup-lettucebo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up Google Play monetization involves two incompatible APIs, permanent product IDs, DRAFT-state activation requirements, and complex regional pricing formats that are easy to get wrong through manual console work. ## Core Features & Use Cases - One-Time Product Management: Create, update, activate, and delete products using the new monetization API with purchase options and regional pricing configs, or manage existing products through the legacy inappproducts API. - Subscription & Offer Setup: Create subscriptions with multiple base plans, bulk-localize listings across all locales in one atomic update, and configure free-trial or introductory-price offers. - Regional Pricing: Convert a base price into per-region prices and obtain the regions version required by create and update commands. - Use Case: You are launching a premium tier for your Android app. Use this Skill to create a monthly and yearly subscription with localized listings in four languages, attach a 7-day free trial offer, and activate the base plans without opening Play Console. ## Quick Start Use the gplay-iap-setup skill to create a monthly subscription with a 7-day free trial for my app com.example.app priced at 4.99 USD.

Frequently Asked Questions about gplay-iap-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a subscription with a free trial on Google Play?▼

Create the subscription with gplay subscriptions create including base plans with billingPeriodDuration, then create an offer with gplay offers create using a phase with pricingType FREE_TRIAL and a duration like P7D. Activate the base plan before users can subscribe.

What is the difference between gplay iap and gplay onetimeproducts?▼

gplay iap uses the legacy inappproducts API with priceMicros and a flat prices map, while gplay onetimeproducts uses the new monetization API with purchaseOptions, units/nanos pricing, and explicit DRAFT-to-ACTIVE activation. Never mix both APIs for the same product.

Can I reuse a Google Play product ID after deleting it?▼

No. Google Play permanently reserves product IDs after deletion, so a deleted ID can never be reused with any API. If an ID is burned, you must choose a new one such as premium_unlock_v2.

Why is my new one-time product not purchasable after creation?▼

New products created via the monetization API start in DRAFT state. You must activate the purchase option with gplay purchase-options batch-update-states before users can buy it.

How do I localize subscription listings for multiple languages?▼

Build a listings-only JSON file with one entry per languageCode containing title, benefits, and description, then run gplay subscriptions update with --update-mask listings. One call sets every locale atomically without touching base plans or pricing.