Bản không dùng nữa

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.

Lộ 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ể gia hạn thời gian sử dụng các mục ngừng sử dụng cho đến ngày 1 tháng 11 năm 2027.

API gói thuê bao ngừng sử dụng

Phần này liệt kê các API ngừng sử dụng.

API	Lựa chọn thay thế hiện có
subscriptions.get	subscriptionsv2.get
subscriptions.refund	Gọi subscriptionsv2.get để lấy SubscriptionPurchaseLineItem. latest_successful_order_id, và 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ó lựa chọ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.offerPhase` (xác định giai đoạn hiện tại: dùng thử miễn phí, giá ưu đãi, phân bổ theo tỷ lệ, giá cơ sở)
(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`	`lineItems.offerPhase.introductoryPrice` Bạ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`: Khoản thanh toán đang chờ xử lý: `SUBSCRIPTION_STATE_PENDING` (giao dịch mua mới đang chờ xử lý) `SUBSCRIPTION_STATE_IN_GRACE_PERIOD` `SUBSCRIPTION_STATE_ON_HOLD` Thanh toán đã được nhận: `SUBSCRIPTION_STATE_ACTIVE` Dùng thử miễn phí: lineItems.offerPhase.freeTrial Tạm hoãn nâng cấp / hạ cấp: `SUBSCRIPTION_STATE_PENDING`
`cancelReason`, `userCancellationTimeMillis`, `cancelSurveyResult`	`canceledStateContext`
`linkedPurchaseToken`	`linkedPurchaseToken` (không có thay đổi)
`purchaseType`	Kiểm thử: thông qua `testPurchase` Khuyế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 khi purchases.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ối purchases.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 đó.