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 hoạt động.
Lịch trình ngừng hoạt động – Từ ngày 19 tháng 5 năm 2026 đến ngày 31 tháng 8 năm 2028
Các tính năng và API trong phần này sẽ ngừng hoạt động kể từ ngày 19 tháng 5 năm 2026 và sẽ ngừng hoạt động hoàn toàn vào ngày 31 tháng 8 năm 2028. Tuy nhiên, bạn có thể gia hạn cho các mục không được dùng nữa cho đến hết ngày 1 tháng 11 năm 2028.
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.
Tiến trình ngừng cung cấp – 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 hoàn toàn vào ngày 31 tháng 8 năm 2027. Tuy nhiên, bạn có thể gia hạn thời gian sử dụng các mục không dùng nữa cho đến hết ngày 1 tháng 11 năm 2027.
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, rồi gọi Orders.refund để hoàn tiền cho đơn đặt hàng. |
| subscriptions.revoke | subscriptionsv2.revoke |
| SubscriptionPurchaseV2. latestOrderId | SubscriptionPurchaseLineItem. latest_successful_order_id |
| RealTimeDeveloperNotification. SubscriptionNotification.subscriptionId | Không 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 |
lineItems.latestSuccessfulOrderIdBạn có thể lấy mã đơn đặt hàng đang chờ xử lý từ inGracePeriodStateContext.renewalDeclined.pendingOrderId hoặc onHoldStateContext.renewalDeclined.pendingOrderId. |
startTimeMillis |
startTime |
expiryTimeMillis |
lineItems.expiryTime (mỗi gói thuê bao có được trong giao dịch mua đều có expiryTime riêng) |
autoResumeTimeMillis |
pausedStateContext.autoResumeTime |
autoRenewing |
lineItems.autoRenewingPlan.autoRenewEnabled |
priceCurrenceCode, priceAmountMicros |
lineItems.autoRenewingPlan.recurringPrice |
introductoryPriceInfo |
lineItems.offerPhase.introductoryPriceBạn cũng 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 |