Google Play Developer API 版本说明

本文档包含 Google Play Developer API 的版本说明。

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，让您可以 将重新订阅购买交易与用户标识符相关联。

• SubscriptionPurchaseLineItem.itemReplacement 字段现已在 SubscriptionPurchaseV2 中提供，该字段提供有关被 替换商品的详细信息（如果适用）。

• 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_id
  • PriceChangeState.CANCELED

• The subscriptionsv2.revoke 方法现在提供 item_based_refund 选项。

• Orders API 现在提供 get 和 batchGet 方法。

其他更改

• 在 purchases.subscriptions API 中，subscriptionId 参数是可选的。