本文档列出了处于弃用期的 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 | (无等效字段)开发者载荷已被废弃 |
paymentState | (无等效字段) 可根据 subscriptionState 推断付款状态:
|
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
。