Tài liệu này bao gồm các ghi chú phát hành cho Google Play Developer API.
Ngày 19 tháng 11 năm 2026
Tính năng mới
Ưu đãi giữ chân người dùng: Giờ đây, bạn có thể tạo ưu đãi giữ chân người dùng để Google Play hiển thị cho những người đăng ký đủ điều kiện khi họ cố gắng huỷ gói thuê bao.
- Nhắm mục tiêu giữ chân người dùng: Để tạo hoặc cập nhật ưu đãi giữ chân người dùng bằng phương thức
monetization.subscriptions.basePlans.offers.create,monetization.subscriptions.basePlans.offers.patchhoặcmonetization.subscriptions.basePlans.offers.batchUpdate, hãy đặtretentionRuletrong trườngtargetingcủa ưu đãi thành đối tượngRetentionTargetingRule. Sử dụng các trườngscope,minDuration,allowMultipleClaimsvàminOfferCooldownDurationđể xác định những người đăng ký đủ điều kiện và liệu họ có thể nhận ưu đãi nhiều lần hay không. - Khung thời gian phát sóng ưu đãi: Tài nguyên
SubscriptionOfferhiện có các trường không bắt buộcstartTimevàendTimeđể đặt thời điểm ưu đãi (chẳng hạn như ưu đãi giữ chân người dùng) bắt đầu và kết thúc. - Nhắm mục tiêu theo người dùng: Để chỉ cung cấp ưu đãi giữ chân cho một số người đăng ký cụ thể, hãy đặt
retentionPerUserRule(RetentionPerUserTargetingRule) trong trườngtargetingcủa ưu đãi. Để nhắm mục tiêu ưu đãi đến một gói thuê bao, hãy gọi phương thứcpurchases.subscriptionsv2.activateOfferTargetingbằngpurchaseTokenvàofferId. Để xoá tiêu chí nhắm mục tiêu, hãy gọi phương thứcpurchases.subscriptionsv2.deactivateOfferTargeting. Tài nguyên SubscriptionPurchaseV2 liệt kê các ưu đãi được nhắm đến từng mục hàng trong trườngdeveloperTargetedOffers, bao gồm cảofferIdvàactivateTimecủa mỗi ưu đãi. - Thông báo chuyển đổi gói: Loại RTDN mới cho gói thuê bao,
SUBSCRIPTION_PLAN_TRANSITION_UPDATED(21), sẽ được gửi khi người đăng ký chấp nhận ưu đãi giữ chân. - Thông tin chi tiết về việc chuyển đổi gói: Tài nguyên SubscriptionPurchaseV2 hiện bao gồm đối tượng
planTransitionDetailstrongautoRenewingPlan. Hàm này xác định ưu đãi giữ chân được chấp nhận trongofferIdvà báo cáo trạng thái chuyển đổi trongtransitionInfo.
- Nhắm mục tiêu giữ chân người dùng: Để tạo hoặc cập nhật ưu đãi giữ chân người dùng bằng phương thức
Xác thực ETag để huỷ và thu hồi gói thuê bao: Các phương thức
purchases.subscriptionsv2.cancelvàpurchases.subscriptionsv2.revokehiện hỗ trợ trườngetagkhông bắt buộc trongCancellationContextvàRevocationContext. Sử dụng trườngetagđể ngăn xung đột khi nhiều yêu cầu sửa đổi cùng một gói thuê bao cùng một lúc. Lấy giá trịetagtừ trườngetagcấp cao nhất được trả về qua lệnh gọipurchases.subscriptionsv2.getgần đây nhất.
Ngày 6 tháng 7 năm 2026
Tính năng mới
Nội dung cập nhật về trách nhiệm chi phí hoàn tiền: Google Play hiện hỗ trợ quy trình phản đối hoàn tiền có sự cộng tác.
Thông báo xem xét yêu cầu hoàn tiền đang chờ xử lý: Một loại thông báo mới theo thời gian thực dành cho nhà phát triển (RTDN) là
PendingRefundReviewNotificationsẽ được gửi khi người dùng yêu cầu hoàn tiền và yêu cầu đó cần bạn xem xét. Các bài đánh giá đang chờ xử lý chỉ hỗ trợCHARGEBACKlàm lý do hoàn tiền.ReviewRefund API: Bạn có thể đánh giá các yêu cầu này và phản hồi trong vòng 24 giờ bằng cách gọi API
orders.reviewrefundmới. Trong lệnh gọi API, bạn phải cung cấp lựa chọn ưu tiên về việc hoàn tiền (chẳng hạn nhưAPPROVE,DECLINEhoặcNEUTRAL) và mọi bằng chứng liên quan đến việc sử dụng giao dịch mua (chẳng hạn như địa chỉ IP của người dùng, tỷ lệ phần trăm mức tiêu thụ tích luỹ và vị trí địa lý tương đối) để giúp Google Play kháng nghị yêu cầu hoàn tiền.
Ngày 19 tháng 5 năm 2026
Tính năng mới
- Mã đơn đặt hàng đang chờ xử lý: API SubscriptionPurchaseV2 hiện bao gồm các trường
onHoldStateContextvàinGracePeriodStateContext. Các trường này cung cấp thêm thông tin chi tiết, chẳng hạn như mã đơn đặt hàng đang chờ xử lý hoặc không thành công, khi một gói thuê bao chuyển sang trạng tháiON_HOLDhoặcIN_GRACE_PERIODdo khoản thanh toán gia hạn bị từ chối.
Deprecations
- Một số API gói thuê bao không còn được dùng nữa. Để biết thêm thông tin, hãy xem bài viết Ngừng sử dụng API gói thuê bao vào tháng 5 năm 2026.
Ngày 27 tháng 1 năm 2026
Tính năng mới
Trì hoãn gói thuê bao có tiện ích bổ sung: Trước đây, API Nhà phát triển Google Play chỉ cho phép trì hoãn thanh toán cho các gói thuê bao đơn lẻ. Chức năng trì hoãn hiện đã có cho cả gói thuê bao đơn lẻ và gói thuê bao có tiện ích bổ sung thông qua phương thức
purchases.subscriptionsv2.defer. Khi bạn trì hoãn ngày tính phí của một gói thuê bao có tiện ích bổ sung, ngày tính phí của tất cả các mặt hàng trong gói thuê bao đó sẽ được trì hoãn theo thời gian đã chỉ định.OfferPhase: Trường
OfferPhasehiện có trong API SubscriptionPurchaseV2. Trường này cung cấp giai đoạn ưu đãi hiện tại của gói thuê bao dưới dạng một trong các giai đoạn: thời gian tính theo tỷ lệ, thời gian dùng thử miễn phí, giá ưu đãi và giá gói cơ bản.
Ngày 19 tháng 11 năm 2025
Tính năng mới
Cải thiện cách xử lý việc đăng ký lại.
- Trường
outOfAppPurchaseContexthiện có trong SubscriptionPurchaseV2, giúp liên kết các giao dịch mua gói thuê bao lại được thực hiện trên Cửa hàng Play bằng cách cung cấp thông tin chi tiết về gói thuê bao đã hết hạn. - Phương thức purchases.subscriptions.acknowledge hiện chấp nhận
externalAccountIdkhông bắt buộc trong phần nội dung yêu cầu, cho phép bạn liên kết giao dịch mua gói thuê bao lại với giá trị nhận dạng người dùng.
- Trường
Trường
SubscriptionPurchaseLineItem.itemReplacementhiện có trong SubscriptionPurchaseV2, cung cấp thông tin chi tiết về mặt hàng được thay thế (nếu có).Orders API hiện có trường
offerPhaseDetails, cung cấp thông tin chi tiết hơn về các đơn đặt hàng tài trợ cho một khoảng thời gian theo tỷ lệ.
Ngày 11 tháng 9 năm 2025
Tính năng mới
API SubscriptionPurchaseV2 hiện cung cấp phương thức
cancel.Phương thức này cải tiến chức năng purchases.subscriptions.cancel hiện có bằng cách hỗ trợ tham số
cancellationTypetrong thư viện ứng dụng.Các tính năng đồng ý tăng giá được cung cấp:
Một trường mới được thêm vào SubscriptionPurchaseV2:
SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.Hiện đã có một loại thông báo mới theo thời gian thực dành cho nhà phát triển: SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED.
Ngày 30 tháng 6 năm 2025
Tính năng mới
- Hiện đã có API ProductPurchaseV2 mới hỗ trợ nhiều lựa chọn mua và ưu đãi cho sản phẩm tính phí một lần.
Ngày 21 tháng 5 năm 2025
Deprecations
- Một số API gói thuê bao không còn được dùng nữa. Để biết thêm thông tin, hãy xem bài viết Ngừng sử dụng Subscription API.
Tính năng mới
Các trường mới sau đây có trong SubscriptionPurchaseV2:
SubscriptionPurchaseLineItem.latest_successful_order_idPriceChangeState.CANCELED
Phương thức
subscriptionsv2.revokehiện cung cấp tuỳ chọnitem_based_refund.
Các thay đổi khác
- Tham số subscriptionId là không bắt buộc trong các API purchases.subscriptions.