本文档包含 Google Play Developer API 的版本说明。
2026 年 7 月 6 日
新功能
拒付费用责任方面的更新：Google Play 现在支持协作式拒付争议处理流程。
待审核的退款通知：当用户提出需要您审核的扣款异议时，系统会发送一种新的实时开发者通知 (RTDN) 类型，即
PendingRefundReviewNotification。待审核的评价仅支持将CHARGEBACK作为退款原因。ReviewRefund API：您可以评估这些请求，并通过调用新的
orders.reviewrefundAPI 在 24 小时内做出回应。在 API 调用中，您必须提供退款偏好设置（例如APPROVE、DECLINE或NEUTRAL）和任何相关的购买使用情况证据（例如用户 IP 地址、累计消耗百分比和粗略的地理位置），以帮助 Google Play 对拒付提出异议。
2026 年 5 月 19 日
新功能
- 待处理订单 ID：SubscriptionPurchaseV2 API 现在包含
onHoldStateContext和inGracePeriodStateContext字段。当订阅因续订付款被拒而进入ON_HOLD或IN_GRACE_PERIOD状态时，这些字段会提供其他详细信息，例如待处理或失败的订单 ID。
弃用
- 部分订阅 API 已弃用。如需了解详情，请参阅2026 年 5 月订阅 API 弃用。
2026 年 1 月 27 日
新功能
含附加项的订阅延期：之前，Google Play Developer API 仅允许延期单个订阅的结算。现在，您可以通过
purchases.subscriptionsv2.defer方法，针对单个订阅和包含加购项的订阅使用延期功能。如果您延迟包含加购项的订阅的结算日期，则该订阅中所有商品的结算日期都会延迟指定的时长。OfferPhase：
OfferPhase字段现已在 SubscriptionPurchaseV2 API 中提供。此字段提供订阅的当前优惠阶段，包括按比例计价期、免费试用期、初次体验价期和基础方案价格期。
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，该 API 支持一次性商品提供多种购买选项和优惠。
2025 年 5 月 21 日
弃用
- 部分订阅 API 已弃用。如需了解详情，请参阅订阅 API 弃用。
新功能
SubscriptionPurchaseV2 中提供了以下新字段：
SubscriptionPurchaseLineItem.latest_successful_order_idPriceChangeState.CANCELED
subscriptionsv2.revoke方法现在提供item_based_refund选项。
其他更改
- 在 purchases.subscriptions API 中，subscriptionId 参数是可选的。