弃用

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

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

本部分中的功能和 API 已于 2025 年 5 月 21 日弃用，并将于 2027 年 8 月 31 日关闭。不过，您可以申请将已弃用的商品的弃用期限延长至 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 SubscriptionPurchaseLineItem.latest_successful_order_id
（无等效字段） lineItems.offerPhase（标识当前阶段：免费试用、初次体验价、按比例计价、基础价格）
（无等效字段） lineItems（SubscriptionPurchaseLineItem 的列表），表示通过购买获得的商品
（无等效字段） lineItems.offerDetails.basePlanId
（无等效字段） lineItems.offerDetails.offerId
（无等效字段） lineItems.offerDetails.offerTags
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime（购买交易中获得的每项订阅都有自己的 expiryTime）
（无等效字段） subscriptionState（表示订阅的状态）
（无等效字段） pausedStateContext（仅当订阅状态为 SUBSCRIPTION_STATE_PAUSED 时才存在）
autoResumeTimeMillis pausedStateContext.autoResumeTime
（无等效字段） canceledStateContext（仅当订阅状态为 SUBSCRIPTION_STATE_CANCELED 时才存在）
（无等效字段） testPurchase（仅在已获许可的测试人员购买交易中才存在）
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
  • 延迟升级/降级：
    • SUBSCRIPTION_STATE_PENDING
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

其他订阅管理函数

虽然 purchases.subscriptions:get 已升级到 purchases.subscriptionsv2:get，但 purchases.subscriptions 端点中的其余开发者订阅管理函数目前保持不变，因此您可以像以前一样继续使用 purchases.subscriptions:acknowledge、purchases.subscriptions:cancel、purchases.subscriptions:defer、purchases.subscriptions:refund 和 purchases.subscriptions:revoke。