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. Đối với các mục không dùng nữa, bạn có thể yêu cầu gia hạn đến ngày 1 tháng 11 năm 2028 bằng cách gửi phiếu yêu cầu hỗ trợ thông qua Play Console > Trợ giúp.
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.
Lịch 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. Đối với các mục không dùng nữa, bạn có thể yêu cầu gia hạn đến ngày 1 tháng 11 năm 2027 bằng cách gửi phiếu yêu cầu hỗ trợ thông qua Play Console > Trợ giúp.
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ó sẵn thiết bị 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 |