弃用

本文档列出了处于弃用期的 Google Play 开发者 API 和相关功能。

弃用时间表 - 2026 年 5 月 19 日至 2028 年 8 月 31 日

本部分中的功能和 API 已于 2026 年 5 月 19 日弃用，并将于 2028 年 8 月 31 日关闭。对于已弃用的项，您可以通过 Play 管理中心 > 帮助提交支持工单，申请将弃用日期延至 2028 年 11 月 1 日。

已弃用的订阅 API

本部分列出了已弃用的 API。

API 可用的替代项
subscriptions.cancel subscriptionsv2.cancel
subscriptions.defer subscriptionsv2.defer
Order.lineItems.subscriptionDetails.offer_phase Order.lineItems.subscriptionDetails.offer_phase_details

弃用时间表 - 2025 年 5 月 21 日至 2027 年 8 月 31 日

本部分中的功能和 API 已于 2025 年 5 月 21 日弃用，并将于 2027 年 8 月 31 日关闭。对于已弃用的 项，您可以通过 Play 管理中心 > 帮助提交 支持工单，申请将弃用日期延至 2027 年 11 月 1 日。

已弃用的订阅 API

本部分列出了已弃用的 API。

API 可用的替代项
subscriptions.get subscriptionsv2.get
subscriptions.refund 调用 subscriptionsv2.get 以获取 SubscriptionPurchaseLineItem. latest_successful_order_id， 然后调用 Orders.refund 以退还订单。
subscriptions.revoke subscriptionsv2.revoke
SubscriptionPurchaseV2。 latestOrderId SubscriptionPurchaseLineItem。 latest_successful_order_id
RealTimeDeveloperNotification。 SubscriptionNotification.subscriptionId 无替代项
RealTimeDeveloperNotification。 SubscriptionNotification。 notificationType SUBSCRIPTION_PRICE_CHANGE_CONFIRMED SUBSCRIPTION_PRICE _CHANGE_UPDATED

周期性订阅的 SubscriptionPurchaseV2 字段

purchases.subscriptionv2 包含一些新字段，用于提供有关新订阅对象的更多详细信息。下表显示了旧订阅端点中的字段与 purchases.subscriptionv2 中相应字段的对应关系。

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId lineItems.latestSuccessfulOrderId
您可以从 inGracePeriodStateContext.renewalDeclined.pendingOrderId或 onHoldStateContext.renewalDeclined.pendingOrderId获取待处理订单 ID。
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime（购买交易中获得的每项订阅都有自己的 expiryTime）
autoResumeTimeMillis pausedStateContext.autoResumeTime
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode、 priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo lineItems.offerPhase.introductoryPrice
您还可以在购买的每项订阅的 offer 中找到此信息。
developerPayload （无等效字段）开发者载荷已被废弃
paymentState （无等效字段）
可根据 subscriptionState 推断付款状态：
  • 付款正在等待处理：
    • SUBSCRIPTION_STATE_PENDING（具有待处理交易的新购买交易）
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • 付款已收讫：
    • SUBSCRIPTION_STATE_ACTIVE
  • 免费试订：
    • lineItems.offerPhase.freeTrial
  • 延迟升级 / 降级：
    • lineItems.deferredItemReplacement
cancelReason、userCancellationTimeMillis、cancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken（无更改）
purchaseType 测试：通过 testPurchase
促销：signupPromotion
priceChange lineItems.autoRenewingPlan.priceChangeDetails
profileName、 emailAddress、 givenName、 familyName、 profileId subscribeWithGoogleInfo
acknowledgementState acknowledgementState (no change)
promotionType、 promotionCode signupPromotion
externalAccountId、 obfuscatedExternalAccountId、 obfuscatedExteranlProfileId externalAccountIdentifiers