本文档包含 Google Play Developer API 的版本说明。
2026 年 11 月 19 日
新功能
留存优惠:您现在可以创建留存优惠,当符合条件的订阅者尝试取消订阅时,Google Play 会向其展示这些优惠。
- 留存定位:如需使用
monetization.subscriptions.basePlans.offers.create、monetization.subscriptions.basePlans.offers.patch或monetization.subscriptions.basePlans.offers.batchUpdate方法创建或更新留存优惠,请将优惠的targeting字段中的retentionRule设置为RetentionTargetingRule对象。使用scope、minDuration、allowMultipleClaims和minOfferCooldownDuration字段来定义哪些订阅者符合条件,以及他们是否可以多次领取优惠。 - 优惠播出时段:
SubscriptionOffer资源现在包含可选的startTime和endTime字段,用于设置优惠(例如留存优惠)的开始和结束时间。 - 按用户定位:如需仅向特定订阅者提供挽留优惠,请在优惠的
targeting字段中设置retentionPerUserRule(RetentionPerUserTargetingRule)。如需将优惠定位到订阅,请使用purchaseToken和offerId调用purchases.subscriptionsv2.activateOfferTargeting方法。如需移除定位条件,请调用purchases.subscriptionsv2.deactivateOfferTargeting方法。SubscriptionPurchaseV2 资源会在developerTargetedOffers字段中列出针对每个订单项的优惠,包括每项优惠的offerId和activateTime。 - 方案转换通知:当订阅者接受留存优惠时,系统会发送新的订阅 RTDN 类型
SUBSCRIPTION_PLAN_TRANSITION_UPDATED(21)。 - 方案转换详情:SubscriptionPurchaseV2 资源现在在
autoRenewingPlan中包含一个planTransitionDetails对象。它会识别offerId中接受的留存优惠,并在transitionInfo中报告过渡状态。
- 留存定位:如需使用
订阅取消和撤消的 ETag 验证:
purchases.subscriptionsv2.cancel和purchases.subscriptionsv2.revoke方法现在支持CancellationContext和RevocationContext中的可选etag字段。当多个请求同时修改同一订阅时,使用etag字段可防止冲突。从最近一次purchases.subscriptionsv2.get调用返回的顶级etag字段中获取etag值。
2026 年 7 月 6 日
新功能
拒付费用分摊责任方面的更新:Google Play 现已支持协作式拒付争议流程。
待处理退款审核通知:当用户请求需要您审核的退款时,系统会发送一种新的实时开发者通知 (RTDN) 类型,即
PendingRefundReviewNotification。待审核的评价仅支持将CHARGEBACK作为退款原因。ReviewRefund API:您可以评估这些请求,并在 24 小时内调用新的
orders.reviewrefundAPI 做出回应。在 API 调用中,您必须提供退款偏好设置(例如APPROVE、DECLINE或NEUTRAL)以及任何相关的购买交易使用情况证据(例如用户 IP 地址、累计消费百分比和粗略地理位置),以帮助 Google Play 对退款提出异议。
2026 年 5 月 19 日
新功能
- 待处理订单 ID:SubscriptionPurchaseV2 API 现在包含
onHoldStateContext和inGracePeriodStateContext字段。当订阅因续订付款被拒而进入ON_HOLD或IN_GRACE_PERIOD状态时,这些字段会提供其他详细信息,例如待处理或失败的订单 ID。
弃用
- 部分订阅 API 已弃用。如需了解详情,请参阅 2026 年 5 月 Subscription API 弃用。
2026 年 1 月 27 日
新功能
含加购项的订阅延期:以前,Google Play Developer API 仅允许对单个订阅进行延期结算。现在,您可以通过
purchases.subscriptionsv2.defer方法对单一订阅和包含加购项的订阅使用延期功能。如果您推迟包含加购项的订阅的结算日期,则该订阅中所有内容的结算日期都会推迟指定的时长。OfferPhase:SubscriptionPurchaseV2 API 中现已提供
OfferPhase字段。此字段提供订阅的当前优惠阶段,包括按比例计价期、免费试用、初次体验价和基础方案价格。
2025 年 11 月 19 日
新功能
-
- SubscriptionPurchaseV2 中现已提供
outOfAppPurchaseContext字段,该字段通过提供已到期订阅的详细信息,帮助关联在 Play 商店中进行的重新订阅购买交易。 - purchases.subscriptions.acknowledge 方法现在接受请求正文中的可选
externalAccountId,以便您将重新订阅购买交易与用户标识符相关联。
- SubscriptionPurchaseV2 中现已提供
SubscriptionPurchaseV2 中现在提供
SubscriptionPurchaseLineItem.itemReplacement字段,该字段会提供有关被替换商品(如有)的详细信息。Orders API 现在包含
offerPhaseDetails字段,该字段可提供有关为按比例计费周期提供资金的订单的更详细信息。
2025 年 9 月 11 日
新功能
SubscriptionPurchaseV2 API 现在提供
cancel方法。此方法通过在客户端库中引入对
cancellationType参数的支持,对现有的 purchases.subscriptions.cancel 功能进行了增强。价格上调同意功能适用于:
SubscriptionPurchaseV2 中添加了一个新字段:
SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details。新增了一种实时开发者通知类型:SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED。
2025 年 6 月 30 日
新功能
- 支持一次性商品的多种购买选项和优惠的新 ProductPurchaseV2 API 现已推出。
2025 年 5 月 21 日
弃用
- 部分订阅 API 已弃用。如需了解详情,请参阅订阅 API 弃用。
新功能
SubscriptionPurchaseV2 中提供了以下新字段:
SubscriptionPurchaseLineItem.latest_successful_order_idPriceChangeState.CANCELED
subscriptionsv2.revoke方法现在提供item_based_refund选项。
其他更改
- subscriptionId 参数在 purchases.subscriptions API 中是可选的。