Google Play Developer API 版本说明

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

2026 年 11 月 19 日

新功能

2026 年 7 月 6 日

新功能

  • 拒付费用分摊责任方面的更新:Google Play 现已支持协作式拒付争议流程。

    • 待处理退款审核通知:当用户请求需要您审核的退款时,系统会发送一种新的实时开发者通知 (RTDN) 类型,即 PendingRefundReviewNotification。待审核的评价仅支持将 CHARGEBACK 作为退款原因。

    • ReviewRefund API:您可以评估这些请求,并在 24 小时内调用新的 orders.reviewrefund API 做出回应。在 API 调用中,您必须提供退款偏好设置(例如 APPROVE、DECLINE 或 NEUTRAL)以及任何相关的购买交易使用情况证据(例如用户 IP 地址、累计消费百分比和粗略地理位置),以帮助 Google Play 对退款提出异议。

2026 年 5 月 19 日

新功能

  • 待处理订单 ID:SubscriptionPurchaseV2 API 现在包含 onHoldStateContext 和 inGracePeriodStateContext 字段。当订阅因续订付款被拒而进入 ON_HOLD 或 IN_GRACE_PERIOD 状态时,这些字段会提供其他详细信息,例如待处理或失败的订单 ID。

弃用

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 中现在提供 SubscriptionPurchaseLineItem.itemReplacement 字段,该字段会提供有关被替换商品(如有)的详细信息。

  • Orders API 现在包含 offerPhaseDetails 字段,该字段可提供有关为按比例计费周期提供资金的订单的更详细信息。

2025 年 9 月 11 日

新功能

2025 年 6 月 30 日

新功能

2025 年 5 月 21 日

弃用

新功能

其他更改