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

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.patch hoặc monetization.subscriptions.basePlans.offers.batchUpdate, hãy đặt retentionRule trong trường targeting của ưu đãi thành đối tượng RetentionTargetingRule. Sử dụng các trường scope, minDuration, allowMultipleClaims và 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 SubscriptionOffer hiện có các trường không bắt buộc startTime và 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ường targeting củ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ức purchases.subscriptionsv2.activateOfferTargeting bằng purchaseToken và offerId. Để xoá tiêu chí nhắm mục tiêu, hãy gọi phương thức purchases.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ường developerTargetedOffers, bao gồm cả offerId và activateTime củ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 planTransitionDetails trong autoRenewingPlan. Hàm này xác định ưu đãi giữ chân được chấp nhận trong offerId và báo cáo trạng thái chuyển đổi trong transitionInfo.
  • Xác thực ETag để huỷ và thu hồi gói thuê bao: Các phương thức purchases.subscriptionsv2.cancel và purchases.subscriptionsv2.revoke hiện hỗ trợ trường etag không bắt buộc trong CancellationContext và RevocationContext. Sử dụng trường etag để 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ị etag từ trường etag cấp cao nhất được trả về qua lệnh gọi purchases.subscriptionsv2.get gầ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à PendingRefundReviewNotification sẽ đượ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ợ CHARGEBACK là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.reviewrefund mớ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, DECLINE hoặc NEUTRAL) 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 onHoldStateContext và 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ái ON_HOLD hoặc IN_GRACE_PERIOD do khoản thanh toán gia hạn bị từ chối.

Deprecations

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 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: 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 outOfAppPurchaseContext hiệ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 externalAccountId khô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 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 theo tỷ lệ.

Ngày 11 tháng 9 năm 2025

Tính năng mới

Ngày 30 tháng 6 năm 2025

Tính năng mới

Ngày 21 tháng 5 năm 2025

Deprecations

Tính năng mới

  • Các trường mới sau đây có trong SubscriptionPurchaseV2:

    • SubscriptionPurchaseLineItem.latest_successful_order_id
    • PriceChangeState.CANCELED
  • Phương thức subscriptionsv2.revoke hiện cung cấp tuỳ 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