Tài liệu này liệt kê các API Nhà phát triển Google Play và các tính năng liên quan đang trong giai đoạn ngừng sử dụng.
Tiến trình ngừng sử dụng – Từ ngày 21 tháng 5 năm 2025 đến ngày 31 tháng 8 năm 2027
Các tính năng và API trong phần này sẽ ngừng hoạt động kể từ ngày 21 tháng 5 năm 2025 và sẽ ngừng hoạt động vào ngày 31 tháng 8 năm 2027. Tuy nhiên, bạn có thể sử dụng một thời gian gia hạn cho các mục không dùng nữa cho đến hết ngày 1 tháng 11 năm 2027.
Các API gói thuê bao không dùng nữa
Phần này liệt kê các API không dùng nữa.
| API | Có thể thay thế |
|---|---|
| subscriptions.get | subscriptionsv2.get |
| subscriptions.refund | Gọi subscriptionsv2.get để lấy SubscriptionPurchaseLineItem. latest_successful_order_id, sau đó gọi Orders.refund để hoàn tiền cho các đơn đặt hàng. |
| subscriptions.revoke | subscriptionsv2.revoke |
| SubscriptionPurchaseV2. latestOrderId | SubscriptionPurchaseLineItem. latest_successful_order_id |
| RealTimeDeveloperNotification. SubscriptionNotification.subscriptionId | Không có phương án thay thế |
| RealTimeDeveloperNotification. SubscriptionNotification. notificationType SUBSCRIPTION_PRICE_CHANGE_CONFIRMED | SUBSCRIPTION_PRICE _CHANGE_UPDATED |
Trường SubscriptionPurchaseV2 cho các gói thuê bao định kỳ
purchases.subscriptionv2 chứa các trường mới cung cấp thêm thông tin về đối tượng thuê bao mới. Bảng sau đây cho thấy cách các trường từ điểm cuối của gói thuê bao liên kết đến các trường tương ứng trong purchases.subscriptionv2.
| SubscriptionPurchase | SubscriptionPurchaseV2 |
|---|---|
countryCode |
regionCode |
orderId |
SubscriptionPurchaseLineItem.latest_successful_order_id |
| (không có trường tương đương) | lineItems (danh sách SubscriptionPurchaseLineItem) biểu thị các sản phẩm có được khi mua hàng |
| (không có trường tương đương) | lineItems.offerDetails.basePlanId |
| (không có trường tương đương) | lineItems.offerDetails.offerId |
| (không có trường tương đương) | lineItems.offerDetails.offerTags |
startTimeMillis |
startTime |
expiryTimeMillis |
lineItems.expiryTime (mỗi gói thuê bao có được trong giao dịch mua đều có expiryTime riêng) |
| (không có trường tương đương) | subscriptionState (cho biết trạng thái của gói thuê bao) |
| (không có trường tương đương) | pausedStateContext (chỉ hiển thị nếu trạng thái của gói thuê bao là SUBSCRIPTION_STATE_PAUSED) |
autoResumeTimeMillis |
pausedStateContext.autoResumeTime |
| (không có trường tương đương) | canceledStateContext (chỉ hiển thị nếu trạng thái của gói thuê bao là SUBSCRIPTION_STATE_CANCELED) |
| (không có trường tương đương) | testPurchase (chỉ hiển thị trong giao dịch mua kiểm thử được cấp phép) |
autoRenewing |
lineItems.autoRenewingPlan.autoRenewEnabled |
priceCurrenceCode, priceAmountMicros |
lineItems.autoRenewingPlan.recurringPrice |
introductoryPriceInfo |
(không có trường tương đương) Bạn có thể tìm thấy thông tin này trong offer cho từng gói thuê bao đã mua. |
| developerPayload | (không có trường tương đương) trọng tải dành cho nhà phát triển đã không còn được dùng nữa |
| paymentState | (không có trường tương đương) Bạn có thể dự đoán trạng thái thanh toán từ subscriptionState:
|
cancelReason, userCancellationTimeMillis, cancelSurveyResult |
canceledStateContext |
linkedPurchaseToken |
linkedPurchaseToken (không có thay đổi) |
purchaseType |
Kiểm thử: thông qua testPurchaseKhuyến mãi: signupPromotion |
priceChange |
lineItems.autoRenewingPlan.priceChangeDetails |
profileName emailAddress, givenName, familyName, profileId |
subscribeWithGoogleInfo |
acknowledgementState |
acknowledgementState (no change) |
promotionType, promotionCode |
signupPromotion |
externalAccountId, obfuscatedExternalAccountId, obfuscatedExteranlProfileId |
externalAccountIdentifiers |
Các chức năng quản lý gói thuê bao khác
Trong khipurchases.subscriptions:get đã được nâng cấp lên purchases.subscriptionsv2:get, các chức năng quản lý thuê bao còn lại của nhà phát triển hiện vẫn không thay đổi trong điểm cuốipurchases.subscriptions để bạn có thể tiếp tục sử dụng purchases.subscriptions:acknowledge .purchases.subscriptions:cancel .purchases.subscriptions:defer .purchases.subscriptions:refund, và purchases.subscriptions:revoke như đã làm trước đó.