本文档列出了处于弃用期的 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 推断支付状态
|
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
,就像以前一样。