ย้ายข้อมูลจากเวอร์ชัน 5 หรือ 6 ไปยัง Google Play Billing Library 7

เอกสารนี้อธิบายวิธีย้ายข้อมูลจาก Google Play Billing Library 5 หรือ 6 ใน Google Play Billing Library 7 และวิธีผสานรวมกับ ความสามารถในการสมัครใช้บริการ

หากต้องการดูรายการการเปลี่ยนแปลงทั้งหมดในเวอร์ชัน 7.0.0 โปรดดูที่รุ่น หมายเหตุ

ภาพรวม

Google Play Billing Library 7 ปรับปรุงการจัดการการชําระเงินสําหรับ คุณลักษณะการสมัครใช้บริการที่มีอยู่ การปรับปรุงที่ไม่บังคับเหล่านี้ เพิ่มการรองรับการชำระเงินด้วยแพ็กเกจการผ่อนชำระ การสนับสนุนสำหรับการซื้อที่รอดำเนินการสำหรับการสมัครใช้บริการแบบชำระเงินล่วงหน้า

การอัปเกรด Play Billing Library ที่เข้ากันได้กับย้อนหลัง

API ของ Google Play Billing Library 7 ใหม่ทั้งหมดเป็นตัวเลือกที่ไม่บังคับ และ นักพัฒนาแอปจึงไม่ต้องใช้การเปลี่ยนแปลง API ใดๆ เพื่ออัปเดต

หากต้องการย้ายข้อมูล คุณต้องอัปเดตการอ้างอิง API และนำออก API บางอย่างจากแอปของคุณตามที่อธิบายไว้ในบันทึกประจำรุ่นและหลังจากนี้ คำแนะนำในการย้ายข้อมูล

อัปเกรดจาก PBL 5 เป็น PBL 7

ส่วนต่อไปนี้จะอธิบายวิธีอัปเกรดจาก PBL 5 เป็น PBL 7

อัปเดตไลบรารี Google Play Billing

อัปเดตเวอร์ชันทรัพยากร Dependency ของ Play Billing Library ใน build.gradle ของแอป

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

จากนั้นอัปเดตการอ้างอิง API ตามที่อธิบายไว้ในส่วนต่อไปนี้

เปลี่ยนแปลงการซื้อการสมัครใช้บริการของผู้ใช้

ใช้ Play Billing Library 5 และรุ่นก่อนหน้า ProrationMode เพื่อใช้การเปลี่ยนแปลงกับการซื้อการสมัครใช้บริการของผู้ใช้ เช่น การอัปเกรด หรือดาวน์เกรด API นี้ถูกนำออกแล้วและแทนที่ด้วย ReplacementMode

จัดการการเปลี่ยนแปลงราคาการสมัครใช้บริการ

ระบบนำ API launchPriceConfirmationFlow ที่เลิกใช้งานไปก่อนหน้านี้ออกแล้ว โปรดดูตัวเลือกอื่นในการเปลี่ยนแปลงราคา

จัดการการเปลี่ยนแปลงที่เกี่ยวข้องกับการสมัครใช้บริการ

API ที่เลิกใช้งานก่อนหน้านี้ setOldSkuPurchaseToken นำ setReplaceProrationMode, setReplaceSkusProrationMode ออกแล้ว

จัดการข้อผิดพลาด Play Billing Library

รหัส NETWORK_ERROR ใหม่จะระบุปัญหาในการเชื่อมต่อเครือข่าย ระหว่างอุปกรณ์ของผู้ใช้กับระบบ Google Play

มีการอัปเดตรหัส SERVICE_TIMEOUT และ SERVICE_UNAVAILABLE ด้วย

สำหรับข้อมูลเพิ่มเติม โปรดดู จัดการโค้ดตอบกลับ BillingResult

จัดการธุรกรรมที่รอดำเนินการ

Play Billing Library จะไม่สร้างรหัสคำสั่งซื้อสำหรับการซื้อที่รอดำเนินการอีกต่อไป สำหรับการซื้อเหล่านี้ ระบบจะป้อนข้อมูลรหัสคำสั่งซื้อหลังจากย้ายการซื้อแล้ว เป็นสถานะ PURCHASED ทำให้แน่ใจว่าการผสานรวมของคุณคาดหวัง รหัสคำสั่งซื้อก็ต่อเมื่อธุรกรรมเสร็จสมบูรณ์แล้วเท่านั้น คุณยังใช้ โทเค็นการซื้อเพื่อการอ้างอิงของคุณ

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการการสั่งซื้อที่รอดำเนินการ คู่มือการผสานรวม Play Billing Library และ คู่มือการจัดการวงจรการซื้อ

จัดการ API การเรียกเก็บเงินระบบอื่นที่นำออก

นำ BillingClient.Builder.enableAlternativeBilling ออกแล้ว AlternativeBillingListener, และ AlternativeChoiceDetails นักพัฒนาแอปควรใช้ BillingClient.Builder.enableUserChoiceBilling() กับ UserChoiceBillingListener และ UserChoiceDetails ใน Callback ของ Listener แทน

การอัปเดตนี้เป็นการเปลี่ยนชื่อ API ที่เลิกใช้งานแล้วโดยไม่มีการเปลี่ยนแปลงลักษณะการทำงาน

การเปลี่ยนแปลงที่ไม่บังคับ

PBL 7 มี API ตัวเลือกใหม่ 2 รายการ

การสนับสนุนการซื้อที่รอดำเนินการสำหรับแพ็กเกจแบบชำระเงินล่วงหน้า

โปรดดูคู่มือจัดการการสมัครใช้บริการและธุรกรรมที่รอดำเนินการ

การสมัครใช้บริการการผ่อนชำระออนไลน์

ดูคู่มือการผสานรวมการสมัครใช้บริการในการผ่อนชำระ

อัปเกรดจาก PBL 6 เป็น PBL 7

ส่วนต่อไปนี้จะอธิบายวิธีอัปเกรดจาก PBL 6 เป็น PBL 7

อัปเดตไลบรารี Google Play Billing

อัปเดตเวอร์ชันทรัพยากร Dependency ของ Play Billing Library ใน build.gradle ของแอป

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

จากนั้นอัปเดตการอ้างอิง API ตามที่อธิบายไว้ในส่วนต่อไปนี้

จัดการการเปลี่ยนแปลงที่เกี่ยวข้องกับการสมัครใช้บริการ

API ที่เลิกใช้งานก่อนหน้านี้ setOldSkuPurchaseToken นำ setReplaceProrationMode, setReplaceSkusProrationMode ออกแล้ว

จัดการ API การเรียกเก็บเงินระบบอื่นที่นำออก

นำ BillingClient.Builder.enableAlternativeBilling ออกแล้ว AlternativeBillingListener และ AlternativeChoiceDetails นักพัฒนาแอปควรใช้ BillingClient.Builder.enableUserChoiceBilling() กับ UserChoiceBillingListener และ UserChoiceDetails ใน Callback ของ Listener แทน

การเปลี่ยนแปลงที่ไม่บังคับ

PBL 7 มี API ตัวเลือกใหม่ 2 รายการ

การสนับสนุนการซื้อที่รอดำเนินการสำหรับแพ็กเกจแบบชำระเงินล่วงหน้า

โปรดดูคู่มือจัดการการสมัครใช้บริการและธุรกรรมที่รอดำเนินการ

การสมัครใช้บริการการผ่อนชำระออนไลน์

ดูคู่มือการผสานรวมการสมัครใช้บริการในการผ่อนชำระสำหรับ เกี่ยวกับวิธีผสานรวมการเปลี่ยนแปลงเหล่านี้ในแอปของคุณ