Google Play Developer API 版本说明

本文档包含 Google Play Developer 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 中现在提供 SubscriptionPurchaseLineItem.itemReplacement 字段，用于提供有关被替换商品的详细信息（如果适用）。

• Orders API 现在包含 offerPhaseDetails 字段，可提供有关按比例分摊时段的订单资金的更详细信息。

• 目前，这些新功能仅通过 API 提供，而不通过客户端库提供。

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

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

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

其他更改

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