บันทึกประจำรุ่นของ Google Play Developer API

เอกสารนี้มีบันทึกประจำรุ่นสำหรับ Google Play Developer API

6 กรกฎาคม 2026

ฟีเจอร์ใหม่

• ข้อมูลอัปเดตเกี่ยวกับการรับผิดชอบค่าใช้จ่ายในการปฏิเสธการชำระเงิน: ตอนนี้ Google Play รองรับกระบวนการโต้แย้งการปฏิเสธการชำระเงินร่วมกันแล้ว

  • การแจ้งเตือนการตรวจสอบการคืนเงินที่รอดำเนินการ: มีการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป (RTDN) ประเภทใหม่ PendingRefundReviewNotification ซึ่งจะส่งเมื่อผู้ใช้ขอปฏิเสธการชำระเงินที่ต้องมีการตรวจสอบจากคุณ รีวิวที่รอดำเนินการรองรับเฉพาะ CHARGEBACK เป็นเหตุผลในการคืนเงิน

  • ReviewRefund API: คุณสามารถประเมินคำขอเหล่านี้และตอบกลับภายใน 24 ชั่วโมงได้โดยเรียกใช้ orders.reviewrefund API ใหม่ ในการเรียก API คุณต้องระบุค่ากำหนดการคืนเงิน (เช่น APPROVE, DECLINE หรือ NEUTRAL) และหลักฐานการใช้งานที่เกี่ยวข้องกับการซื้อ (เช่น ที่อยู่ IP ของผู้ใช้ เปอร์เซ็นต์การใช้งานสะสม และตำแหน่งทางภูมิศาสตร์แบบหยาบ) เพื่อช่วยให้ Google Play โต้แย้งการปฏิเสธการชำระเงินได้

19 พฤษภาคม 2026

ฟีเจอร์ใหม่

• รหัสคำสั่งซื้อที่รอดำเนินการ: ตอนนี้ API SubscriptionPurchaseV2 มีฟิลด์ onHoldStateContext และ inGracePeriodStateContext แล้ว ฟิลด์เหล่านี้ ให้รายละเอียดเพิ่มเติม เช่น รหัสคำสั่งซื้อที่รอดำเนินการหรือล้มเหลว เมื่อการสมัครใช้บริการเข้าสู่สถานะON_HOLDหรือIN_GRACE_PERIODเนื่องจาก การชำระเงินสำหรับการต่ออายุถูกปฏิเสธ

Deprecations

• เราเลิกใช้งาน Subscription API บางรายการแล้ว ดูข้อมูลเพิ่มเติมได้ที่การเลิกใช้งาน Subscription API ในเดือนพฤษภาคม 2026

27 มกราคม 2026

ฟีเจอร์ใหม่

• การเลื่อนการเรียกเก็บเงินสำหรับการสมัครใช้บริการที่มีส่วนเสริม: ก่อนหน้านี้ Google Play Developer API อนุญาตให้เลื่อนการเรียกเก็บเงินสำหรับการสมัครใช้บริการแบบเดียวเท่านั้น ตอนนี้ฟังก์ชันการเลื่อนการเรียกเก็บเงินพร้อมให้บริการสำหรับการสมัครใช้บริการแบบเดี่ยวและการสมัครใช้บริการที่มีส่วนเสริมผ่านวิธีการของ purchases.subscriptionsv2.defer แล้ว เมื่อเลื่อนวันที่เรียกเก็บเงิน ของการสมัครใช้บริการที่มีส่วนเสริม วันที่เรียกเก็บเงินสำหรับรายการทั้งหมดในการ สมัครใช้บริการจะเลื่อนออกไปตามระยะเวลาที่ระบุ

• OfferPhase: ตอนนี้ฟิลด์ OfferPhase พร้อมใช้งานใน API SubscriptionPurchaseV2 แล้ว ฟิลด์นี้ระบุเฟสของข้อเสนอปัจจุบัน ของการสมัครใช้บริการเป็นระยะเวลาตามสัดส่วน ช่วงทดลองใช้ฟรี ราคาช่วงแนะนำ และราคาแพ็กเกจเริ่มต้น

19 พฤศจิกายน 2025

ฟีเจอร์ใหม่

• การจัดการการสมัครใช้บริการอีกครั้งที่ดียิ่งขึ้น

  • ตอนนี้ฟิลด์ outOfAppPurchaseContext พร้อมใช้งานแล้วใน SubscriptionPurchaseV2 ซึ่งจะช่วยลิงก์การซื้อการสมัครใช้บริการอีกครั้งที่ทำจาก Play Store โดยให้รายละเอียดจากการสมัครใช้บริการที่หมดอายุ
  • ตอนนี้เมธอด purchases.subscriptions.acknowledge ยอมรับ externalAccountId ที่ไม่บังคับในส่วนเนื้อหาของคำขอ ซึ่งช่วยให้คุณ เชื่อมโยงการซื้อการสมัครใช้บริการซ้ำกับตัวระบุผู้ใช้ได้

• SubscriptionPurchaseLineItem.itemReplacement พร้อมใช้งานแล้วใน SubscriptionPurchaseV2 ซึ่งมีรายละเอียดเกี่ยวกับรายการที่ ถูกแทนที่ หากมี

• ตอนนี้ Orders API มีฟิลด์ offerPhaseDetails ซึ่งให้ข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับการสั่งซื้อที่ให้เงินทุนสำหรับระยะเวลาตามสัดส่วน

11 ก.ย. 2025

ฟีเจอร์ใหม่

• ตอนนี้ API SubscriptionPurchaseV2 มีเมธอด cancel แล้ว

  วิธีนี้จะช่วยปรับปรุงฟังก์ชัน purchases.subscriptions.cancel ที่มีอยู่โดยการรองรับพารามิเตอร์ cancellationType ในไลบรารีของไคลเอ็นต์

• ฟีเจอร์ความยินยอมในการปรับราคาขึ้นพร้อมให้ใช้งานแล้วใน

  • มีการเพิ่มฟิลด์ใหม่ใน SubscriptionPurchaseV2 ดังนี้ SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details

  • มีการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปประเภทใหม่ SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED

30 มิถุนายน 2025

ฟีเจอร์ใหม่

• API ProductPurchaseV2 ใหม่ที่รองรับตัวเลือกการซื้อหลายรายการ และข้อเสนอสำหรับผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวพร้อมใช้งานแล้ว

21 พฤษภาคม 2025

Deprecations

• เราเลิกใช้งาน Subscription API บางรายการแล้ว ดูข้อมูลเพิ่มเติมได้ที่การเลิกใช้งาน Subscription API

ฟีเจอร์ใหม่

• ฟิลด์ใหม่ต่อไปนี้พร้อมใช้งานใน SubscriptionPurchaseV2

  • SubscriptionPurchaseLineItem.latest_successful_order_id
  • PriceChangeState.CANCELED

• ตอนนี้วิธี subscriptionsv2.revoke มีตัวเลือก item_based_refund แล้ว

• ตอนนี้ API Orders มีเมธอด get และ batchGet แล้ว

การเปลี่ยนแปลงอื่นๆ

• พารามิเตอร์ subscriptionId เป็นพารามิเตอร์ที่ไม่บังคับใน API purchases.subscriptions