如何通过Google Play Developer API关联订阅内购与对应Base Plan及Offer？

一、如何关联Play Console中的Base Plan与Offer #

针对v1接口（purchases.subscriptions） #

v1接口确实未直接返回Base Plan或Offer的标识符，可通过以下方式关联：

• 利用返回的productId（订阅主ID），结合Play Console中该订阅的所有Base Plan/Offer配置，通过计费周期、购买价格、生效时间等维度反向匹配对应的方案；
• 如果业务侧在用户购买时已留存了所选的Base Plan/Offer ID（比如前端下单时上报、后端记录），可直接通过该记录关联。

针对v2接口（purchases.subscriptionsv2） #

v2接口的lineItems数组中，每个条目嵌套的offerDetails字段包含了关键的关联信息：

• lineItems[].offerDetails.basePlanId：对应当前购买所用的Base Plan ID（与Play Console中配置的一致）；
• lineItems[].offerDetails.offerId：如果用户通过优惠方案购买，该字段会返回对应的Offer ID（无优惠时可能为空）。

二、v2接口中的价格与货币信息位置 #

v1接口的priceCurrencyCode（货币码）和priceAmountMicros（金额，微单位），在v2接口中对应：

• 常规订阅价格：lineItems[].price.amountMicros（金额）和lineItems[].price.currencyCode（货币码）；
• 促销阶段价格：如果购买包含优惠定价阶段，对应价格信息在lineItems[].offerDetails.pricingPhase.price字段中，同样包含amountMicros和currencyCode。

内容的提问来源于stack exchange，提问作者Kamo Spertsian