本文件列出 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 |
週期或經常性訂閱項目的 PurchasePurchaseV2 欄位
purchases.subscriptionv2
包含新欄位,可提供新訂閱物件的詳細資訊。下表顯示舊版訂閱項目端點的欄位如何對應至 purchases.subscriptionv2
中的對應欄位。
訂閱購買 | 訂閱購買第 2 版 |
---|---|
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 Promotion: 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
。