跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
搜索与研究

gplay-ppp-pricing

Set region-specific pricing for subscriptions and in-app purchases using purchasing power parity (PPP). Use when adjusting prices by country or implementing localized pricing strategies on Google Play.

tamtom · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add tamtom/gplay-cli-skills --skill gplay-ppp-pricing

技能说明


name: gplay-ppp-pricing description: Set region-specific pricing for subscriptions and in-app purchases using purchasing power parity (PPP). Use when adjusting prices by country or implementing localized pricing strategies on Google Play.

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."

Critical: Currency codes come from Google Play, not from assumptions

Do NOT hardcode currency-to-region mappings. Currency codes vary depending on the --regions-version value (e.g., Bulgaria BG uses BGN in older versions but EUR in newer versions after eurozone adoption).

Always use the currency codes from the fetched existing regional configs. For PPP target regions where you override the price, use the currency from the multiplier table below. For all other regions, preserve the existing currency exactly as returned by Google Play.

PPP Multiplier Table

Apply these multipliers to the base USD price. Round all results to .99 endings (e.g., $4.73 → $4.99, ₹249.37 → ₹249.99).

Tier 1 — Full Price (1.0x–1.1x)

RegionCodeMultiplierCurrency
United StatesUS1.0xUSD
United KingdomGB1.0xGBP
GermanyDE1.0xEUR
AustraliaAU1.0xAUD
SwitzerlandCH1.1xCHF
CanadaCA1.0xCAD
NetherlandsNL1.0xEUR
SwedenSE1.0xSEK
NorwayNO1.05xNOK
DenmarkDK1.0xDKK

Tier 2 — Medium (0.6x–0.8x)

RegionCodeMultiplierCurrency
FranceFR0.8xEUR
SpainES0.7xEUR
ItalyIT0.7xEUR
JapanJP0.8xJPY
South KoreaKR0.7xKRW
PolandPL0.6xPLN
PortugalPT0.7xEUR
Czech RepublicCZ0.6xCZK
GreeceGR0.65xEUR
ChileCL0.6xCLP
Saudi ArabiaSA0.8xSAR
UAEAE0.8xAED

Tier 3 — Low (0.3x–0.5x)

RegionCodeMultiplierCurrency
IndiaIN0.3xINR
BrazilBR0.5xBRL
MexicoMX0.45xMXN
IndonesiaID0.3xIDR
TurkeyTR0.35xTRY
VietnamVN0.3xVND
PhilippinesPH0.35xPHP
EgyptEG0.3xEGP
ColombiaCO0.4xCOP
ArgentinaAR0.3xARS
NigeriaNG0.3xNGN
PakistanPK0.25xPKR
ThailandTH0.4xTHB
MalaysiaMY0.45xMYR
South AfricaZA0.4xZAR
UkraineUA0.3xUAH

Workflow: Set PPP-Based IAP Pricing (legacy inappproducts API)

Use this workflow for legacy managed products created via gplay iap. These use the priceMicros/currency format.

1. List in-app products

gplay iap list --package "PACKAGE"

2. Get current product details

gplay iap get --package "PACKAGE" --sku "SKU"

Note the current defaultPrice as your base price, and save all existing prices entries.

3. Build PPP-adjusted prices JSON (fetch-then-merge)

You must include ALL existing region prices, not just PPP targets. Fetch the current product, then override PPP regions.

{
  "sku": "premium_upgrade",
  "defaultPrice": {
    "priceMicros": "9990000",
    "currency": "USD"
  },
  "prices": {
    "US": { "priceMicros": "9990000", "currency": "USD" },
    "IN": { "priceMicros": "2499900", "currency": "INR" },
    "BR": { "priceMicros": "24990000", "currency": "BRL" },
    "GB": { "priceMicros": "9990000", "currency": "GBP" },
    "DE": { "priceMicros": "9990000", "currency": "EUR" }
  }
}

4. Update the product

gplay iap update \
  --package "PACKAGE" \
  --sku "SKU" \
  --json @ppp-prices.json

5. Verify prices

gplay iap get --package "PACKAGE" --sku "SKU"

Workflow: Create New One-Time Product with PPP Pricing

Use this workflow when creating a brand new one-time product with PPP pricing from scratch.

1. Reference an existing produc

阅读完整来源 ↗