弃用

本文档列出了处于弃用期的 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（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 (无等效字段)
您可以在购买的每项订阅的 offer 中找到此信息。
developerPayload (无等效字段) developer payload 已弃用
paymentState (无等效字段)
您可以根据 subscriptionState 推断支付状态
  • 待付款
    • SUBSCRIPTION_STATE_PENDING（含待处理交易的新购买）
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • 已收到付款
    • SUBSCRIPTION_STATE_ACTIVE
  • 免费试用
    • 您可以通过 Orders.get API 获取的 Order.line_items.subscription_details.offer_phase 字段。
  • 延迟升级/降级
    • SUBSCRIPTION_STATE_PENDING
cancelReason、userCancellationTimeMillis、cancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken（无变化）
purchaseType 测试：通过 testPurchase
促销：signupPromotion
priceChange lineItems.autoRenewingPlan.priceChangeDetails
profileName、emailAddress、givenName、familyName、profileId subscribeWithGoogleInfo
acknowledgementState acknowledgementState（无变化）
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，就像以前一样。