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)