弃用

本文档列出了处于弃用期的 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
priceCurrenceCodepriceAmountMicros 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
cancelReasonuserCancellationTimeMilliscancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken(无变化)
purchaseType 测试:通过 testPurchase
促销:signupPromotion
priceChange lineItems.autoRenewingPlan.priceChangeDetails
profileNameemailAddressgivenNamefamilyNameprofileId subscribeWithGoogleInfo
acknowledgementState acknowledgementState(无变化)
promotionTypepromotionCode signupPromotion
externalAccountIdobfuscatedExternalAccountIdobfuscatedExteranlProfileId externalAccountIdentifiers

其他订阅管理函数

虽然 purchases.subscriptions:get 已升级为 purchases.subscriptionsv2:get,但 purchases.subscriptions 端点中其余的开发者订阅管理函数目前保持不变,因此您可以继续使用 purchases.subscriptions:acknowledgepurchases.subscriptions:cancelpurchases.subscriptions:deferpurchases.subscriptions:refundpurchases.subscriptions:revoke,就像以前一样。