Ghi chú phát hành API Nhà phát triển Google Play

Tài liệu này chứa các ghi chú phát hành cho Google Play Developer API.

Ngày 27 tháng 1 năm 2026

Tính năng mới

• Gói thuê bao có tiện ích bổ sung bị hoãn: Trước đây, API Nhà phát triển Google Play chỉ cho phép hoãn thanh toán đối với gói thuê bao đơn lẻ. Giờ đây, bạn có thể sử dụng chức năng hoãn thanh toán cho cả gói thuê bao riêng 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 hoãn ngày thanh toán của một gói thuê bao có tiện ích bổ sung, ngày thanh toán của tất cả các mục trong gói thuê bao đó sẽ được hoãn theo khoảng thời gian đã chỉ định.

• OfferPhase: Trường OfferPhase hiệ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 theo tỷ lệ, 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ý yêu cầu đăng ký lại.

  • Trường outOfAppPurchaseContext hiện có trong SubscriptionPurchaseV2, giúp liên kết các giao dịch mua để đăng ký lại được thực hiện qua 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 externalAccountId không bắt buộc trong nội dung yêu cầu, cho phép bạn liên kết giao dịch mua đăng ký lại với giá trị nhận dạng người dùng.

• Trường SubscriptionPurchaseLineItem.itemReplacement hiệ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 được tính theo tỷ lệ.

• Hiện tại, những tính năng mới này chỉ có thông qua API chứ không có thông qua thư viện ứng dụng.

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 giúp cải thiện chức năng purchases.subscriptions.cancel hiện có bằng cách hỗ trợ tham số cancellationType trong các thư viện ứng dụng.

• Các tính năng đồng ý tăng giá từng bước hiện có:

  • Một trường mới được thêm vào SubscriptionPurchaseV2: SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.

  • 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 hiện đã có.

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

Ngừng sử dụng

• Một số API thuê bao không đượ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

• Bạn có thể sử dụng các trường mới sau đây trong SubscriptionPurchaseV2:

  • SubscriptionPurchaseLineItem.latest_successful_order_id
  • PriceChangeState.CANCELED

• Phương thức subscriptionsv2.revoke hiện cung cấp lựa chọn item_based_refund.

• API Orders hiện cung cấp các phương thức get và batchGet.

Các thay đổi khác

• Tham số subscriptionId là không bắt buộc trong API purchases.subscriptions.