gplay-ppp-pricing

PPP Pricing (Per-Region Pricing)

Use this skill to set different prices for different countries based on purchasing power parity or custom pricing strategies.

Preconditions

• Ensure credentials are set (gplay auth login --service-account or GPLAY_SERVICE_ACCOUNT env var).
• Use GPLAY_PACKAGE or pass --package explicitly.
• Know your base region (usually US) and base price.

Critical: Required flags

When updating subscriptions or one-time products that modify pricing, you must provide:

• --regions-version: Required by the Google Play API when updating regional pricing. Use the latest version. If you don't know the current version, send any value (e.g., "2022/02") — the API error will tell you the latest (e.g., latest value is ExternalRegionLaunchVersionId{versionId=2025/03}). Then retry with the correct version.
• --update-mask "basePlans": Required for subscription updates. Without it, the API returns: "update_mask must contain at least one path."
• For one-time products, use --update-mask "purchaseOptions".

Critical: Preserve all existing regions (fetch-then-merge)

The Google Play API rejects updates that remove existing regional configs. If a subscription already has 173 regions configured and you send only 30 PPP regions, the API returns: "Regional configs were removed from the base plan: BM, BO, CI..."

Always follow the fetch-then-merge pattern:

1. Fetch the current product to get ALL existing regional configs
2. Override only the PPP target regions with your calculated prices
3. Send the complete merged list (all original regions + PPP overrides)

This also applies to:

• otherRegionsConfig for subscriptions — if it was previously set on a base plan, it must be included in the update JSON.
• newRegionsConfig for one-time product purchase options — if it was previously set (with usdPrice, eurPrice, and availability), it must be included. Omitting it causes: "Cannot remove currency for new regions once it has been added: EUR."