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

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

ดูรายการการเปลี่ยนแปลงทั้งหมดในเวอร์ชัน 6.0.0 ได้ที่บันทึกประจำรุ่น

ภาพรวม

Google Play Billing Library 6 สร้างขึ้นจากฟีเจอร์การสมัครใช้บริการใหม่ที่เปิดตัวในเวอร์ชัน 5 และเพิ่มการปรับปรุงอีกเล็กน้อย ฟีเจอร์เหล่านี้ช่วยให้คุณขายการสมัครใช้บริการได้หลายวิธีมากขึ้น ซึ่งจะช่วยลดต้นทุนในการดำเนินการด้วยการขจัดความจำเป็นในการสร้างและจัดการ SKU ที่เพิ่มขึ้นเรื่อยๆ

ดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์ใหม่ที่เปิดตัวพร้อมกับ Play Billing Library 5 ได้ที่การเปลี่ยนแปลงล่าสุดในการสมัครใช้บริการใน Play Console

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

ผลิตภัณฑ์ที่ต้องสมัครใช้บริการที่มีอยู่ทั้งหมดได้รับการแปลงเป็นกระบวนทัศน์ใหม่นี้โดยอัตโนมัติ ซึ่งเป็นส่วนหนึ่งของการเปิดตัว Play Billing Library 5 และแพลตฟอร์มการสมัครใช้บริการใหม่ในเดือนพฤษภาคม 2022 ซึ่งหมายความว่าคุณไม่จำเป็นต้องเปลี่ยนแปลงการกำหนดค่าผลิตภัณฑ์ที่ต้องสมัครใช้บริการเพื่อให้มีแคตตาล็อกที่เข้ากันได้กับ Play Billing Library เวอร์ชันใหม่ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีแปลง SKU การสมัครใช้บริการเป็นการสมัครใช้บริการที่เข้ากันได้แบบย้อนหลังได้ที่ส่วนการทำงานกับการสมัครใช้บริการที่เก่ากว่าในบทความช่วยเหลือของ Play Console

แอปเวอร์ชันก่อนหน้าจะยังคงใช้งานได้

หากคุณมีแคตตาล็อกการสมัครใช้บริการที่เข้ากันได้แบบย้อนหลัง แอปทุกเวอร์ชันที่มีอยู่ควรยังคงทำงานตามที่ตั้งใจไว้สำหรับผลิตภัณฑ์เหล่านั้น การซื้อผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวควรทํางานต่อไปได้โดยไม่มีปัญหาในเวอร์ชันก่อนหน้า

แอปเวอร์ชันที่ใช้วิธีการที่เลิกใช้งานแล้ว (เช่น querySkuDetailsAsync()) จะขายแพ็กเกจเริ่มต้นหรือข้อเสนอที่เข้ากันไม่ได้แบบย้อนหลังไม่ได้ อ่านเกี่ยวกับข้อเสนอที่เข้ากันได้แบบย้อนหลังได้ในบทความในศูนย์ช่วยเหลือของ Play Console ที่เกี่ยวข้อง

อัปเกรดเป็น Play Billing Library 5 หรือ 6

Play Billing Library 5 และ 6 มีเมธอดที่เลิกใช้งานแล้วอย่าง querySkuDetailsAsync และ BillingFlowParams.Builder.setSkuDetails ซึ่งใช้ SkuDetails เป็นพารามิเตอร์โฟลว์การเรียกเก็บเงิน ซึ่งหมายความว่าคุณสามารถค่อยๆ ย้ายไปใช้ Play Billing Library 6 ได้โดยวางแผนการย้ายข้อมูลเป็นระยะๆ

ขั้นตอนแรกในการย้ายข้อมูลคือคุณสามารถอัปเดตเวอร์ชันไลบรารี โดยปล่อยแคตตาล็อกและแบ็กเอนด์ไว้เหมือนเดิม และทดสอบแอปขณะที่ยังคงใช้วิธีการที่เลิกใช้งานแล้ว หากคุณไม่ได้ใช้ queryPurchases, launchPriceChangeFlow หรือ setVrPurchaseFlow ระบบก็ควรจะยังทำงานได้ตามที่ต้องการ หลังจากนั้น คุณสามารถทำซ้ำเพื่อใช้ฟีเจอร์การสมัครใช้บริการใหม่ที่เปิดตัวในเดือนพฤษภาคม 2022 ได้อย่างเต็มรูปแบบ

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

ขั้นตอนการย้ายข้อมูลแบบเต็ม

สร้างการสมัครใช้บริการใหม่ในแคตตาล็อกสินค้าแบ็กเอนด์

ตอนนี้คุณสามารถกำหนดค่าให้กับการสมัครใช้บริการหนึ่งๆ ด้วยแพ็กเกจเริ่มต้นหลายแบบ โดยแต่ละแบบมีหลายข้อเสนอได้เมื่อใช้ Play Developer Console หรือ Play Developer API ข้อเสนอการสมัครใช้บริการมีรูปแบบการกําหนดราคาและตัวเลือกคุณสมบัติที่ยืดหยุ่น คุณสามารถสร้างข้อเสนอได้ตลอดวงจรการสมัครใช้บริการ โดยใช้แพ็กเกจการต่ออายุใหม่อัตโนมัติและแพ็กเกจแบบชำระเงินล่วงหน้าหลากหลายรูปแบบ

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

ปล่อยผลิตภัณฑ์ที่ต้องสมัครใช้บริการที่แปลงแล้วไว้โดยไม่มีการแก้ไขหลังจากรุ่นเดือนพฤษภาคม 2022 เพื่อให้แอปเวอร์ชันที่ใช้วิธีการที่เลิกใช้งานแล้ว (เช่น querySkuDetailsAsync()) ขายผลิตภัณฑ์เหล่านั้นต่อไปได้โดยไม่ส่งผลกระทบต่อบิลด์เหล่านั้น

กระบวนการแปลงทำให้ผลิตภัณฑ์ที่ต้องสมัครใช้บริการซึ่งอยู่ในแคตตาล็อกของคุณก่อนเดือนพฤษภาคม 2022 เป็นแบบอ่านอย่างเดียว เพื่อหลีกเลี่ยงการเปลี่ยนแปลงโดยไม่ตั้งใจซึ่งอาจส่งผลให้เกิดปัญหาเกี่ยวกับการผสานรวมที่มีอยู่ คุณสามารถเปลี่ยนแปลงการสมัครใช้บริการเหล่านี้ได้ แต่จะมีผลกระทบที่อาจส่งผลต่อการผสานรวมฟรอนท์เอนด์และแบ็กเอนด์ ดังนี้

  • ในส่วนฟรอนท์เอนด์ เวอร์ชันแอปที่ใช้ querySkuDetailsAsync() เพื่อรับรายละเอียดผลิตภัณฑ์ที่ต้องสมัครใช้บริการจะขายได้เฉพาะแพ็กเกจเริ่มต้นและข้อเสนอที่เข้ากันได้แบบย้อนหลังเท่านั้น และจะมีแพ็กเกจเริ่มต้นและข้อเสนอที่เข้ากันได้แบบย้อนหลังได้เพียงชุดเดียว ดังนั้นหากคุณเพิ่มแพ็กเกจหรือข้อเสนอใหม่ลงในการสมัครใช้บริการที่แปลงแล้ว แพ็กเกจเริ่มต้นหรือข้อเสนอใหม่ที่เพิ่มเข้ามาจะขายในแอปเวอร์ชันก่อนหน้าเหล่านี้ไม่ได้

  • ในแบ็กเอนด์ หากคุณแก้ไขการสมัครใช้บริการที่แปลงแล้วใน UI ของ Play Console คุณจะจัดการการสมัครใช้บริการเหล่านั้นด้วยปลายทาง inappproducts ไม่ได้ หากคุณเรียกใช้ปลายทางเพื่อวัตถุประสงค์นี้ นอกจากนี้ คุณควรย้ายข้อมูลไปยังปลายทางสถานะการซื้อการสมัครใช้บริการใหม่ (purchases.subscriptionsv2.get) เพื่อจัดการการซื้อสำหรับการสมัครใช้บริการเหล่านี้ เนื่องจากปลายทางสถานะการซื้อเดิม (purchases.subscriptions.get) จะแสดงเฉพาะข้อมูลที่จำเป็นในการจัดการการซื้อแพ็กเกจเริ่มต้นและข้อเสนอที่เข้ากันได้แบบย้อนหลังเท่านั้น อ่านข้อมูลเพิ่มเติมได้ที่ส่วนจัดการสถานะการซื้อการสมัครใช้บริการ

จัดการแคตตาล็อกการสมัครใช้บริการแบ็กเอนด์ด้วย API ใหม่

หากคุณจัดการแคตตาล็อกสินค้าที่ต้องสมัครใช้บริการโดยอัตโนมัติด้วย Google Play Developer API คุณจะต้องใช้ปลายทางคำจำกัดความของผลิตภัณฑ์ที่ต้องสมัครใช้บริการใหม่เพื่อสร้างและจัดการการสมัครใช้บริการ แพ็กเกจเริ่มต้น และข้อเสนอ อ่านคู่มือฟีเจอร์การสมัครใช้บริการฉบับเดือนพฤษภาคม 2022 เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลง API แคตตาล็อกสินค้าสำหรับรุ่นนี้

หากต้องการย้ายข้อมูลโมดูลการจัดการแคตตาล็อกสินค้าอัตโนมัติสำหรับการสมัครใช้บริการ Google Play Billing ให้แทนที่ inappproducts API ด้วย Subscription Publishing API ใหม่เพื่อจัดการและเผยแพร่แคตตาล็อกการสมัครใช้บริการ โดยมีปลายทางใหม่ 3 รายการดังนี้

  • Monetization.subscriptions เพื่อจัดการผลิตภัณฑ์ที่ต้องสมัครใช้บริการ
  • Monetization.basePlans เพื่อจัดการแพ็กเกจเริ่มต้นสำหรับการสมัครใช้บริการ
  • Monetization.offers เพื่อจัดการข้อเสนอสำหรับแพ็กเกจเริ่มต้น

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

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

แอปเวอร์ชันที่ใช้วิธีการที่เลิกใช้งานแล้ว (เช่น querySkuDetailsAsync()) จะขายแพ็กเกจเริ่มต้นหรือข้อเสนอที่เข้ากันไม่ได้แบบย้อนหลังไม่ได้ อ่านเกี่ยวกับข้อเสนอที่เข้ากันได้แบบย้อนหลังได้ในบทความช่วยเหลือของ Play Console

อัปเดต Google Play Billing Library

เมื่อสร้างแคตตาล็อกผลิตภัณฑ์ที่ต้องสมัครใช้บริการใหม่แล้ว คุณจะย้ายข้อมูลแอปไปยัง Google Billing Library 5 ได้ แทนที่ทรัพยากร Dependency ของ Play Billing Library ที่มีอยู่ด้วยเวอร์ชันที่อัปเดตในไฟล์ build.gradle ของแอป

dependencies {
    def billingVersion = "6.0.0"

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

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

เริ่มต้นใช้งาน Billing Client และสร้างการเชื่อมต่อกับ Google Play

ขั้นตอนแรกในการเปิดตัวการซื้อจากแอป Android ยังคงเหมือนเดิม ดังนี้

แสดงผลิตภัณฑ์ที่พร้อมจำหน่าย

วิธีรับข้อเสนอทั้งหมดที่ผู้ใช้มีสิทธิ์ซื้อมีดังนี้

  • แทนที่ SkuDetailsParams ด้วย QueryProductDetailsParams
  • เปลี่ยนการโทร BillingClient.querySkuDetailsAsync() ไปใช้ BillingClient.queryProductDetailsAsync()

โปรดทราบว่าตอนนี้ผลการค้นหาเป็น ProductDetails แทนที่จะเป็น SkuDetails รายการ ProductDetails แต่ละรายการจะมีข้อมูลเกี่ยวกับผลิตภัณฑ์ (รหัส ชื่อ ประเภท และอื่นๆ) สำหรับผลิตภัณฑ์ที่ต้องสมัครใช้บริการ ProductDetails จะมี List<ProductDetails.SubscriptionOfferDetails> ซึ่งเป็นรายการรายละเอียดข้อเสนอการสมัครใช้บริการ สำหรับผลิตภัณฑ์ที่ซื้อครั้งเดียว ProductDetails จะมี ProductDetails.OneTimePurchaseOfferDetails ซึ่งสามารถใช้เพื่อตัดสินใจว่าจะแสดงข้อเสนอใดต่อผู้ใช้

ตัวอย่างต่อไปนี้แสดงลักษณะของแอปก่อนและหลังทำการเปลี่ยนแปลงเหล่านี้

ก่อน

Kotlin

val skuList = ArrayList<String>()

skuList.add("up_basic_sub")

val params = SkuDetailsParams.newBuilder()

params.setSkusList(skuList).setType(BillingClient.SkuType.SUBS).build()

billingClient.querySkuDetailsAsync(params) {
    billingResult,
    skuDetailsList ->
    // Process the result
}

Java

List<String> skuList = new ArrayList<>();

skuList.add("up_basic_sub");

SkuDetailsParams.Builder params = SkuDetailsParams.newBuilder();

params.setSkusList(skuList).setType(SkuType.SUBS).build();

billingClient.querySkuDetailsAsync(params,
    new SkuDetailsResponseListener() {
        @Override
        public void onSkuDetailsResponse(BillingResult billingResult,
                List<SkuDetails> skuDetailsList) {
            // Process the result.
        }
    }
);

หลัง

Kotlin

val productList =
    listOf(
        QueryProductDetailsParams.Product.newBuilder()
            .setProductId("up_basic_sub")
            .setProductType(BillingClient.ProductType.SUBS)
            .build()
    )

val params = QueryProductDetailsParams.newBuilder().setProductList(productList).build()

billingClient.queryProductDetailsAsync(params) {
    billingResult,
    productDetailsList ->
    // Process the result
}

Java

ImmutableList<Product> productList = ImmutableList.of(Product.newBuilder()
                                            .setProductId("up_basic_sub")
                                            .setProductType(ProductType.SUBS)
                                            .build());

QueryProductDetailsParams params = QueryProductDetailsParams.newBuilder()
    .setProductList(productList)
    .build();

billingClient.queryProductDetailsAsync(
        params,
        new ProductDetailsResponseListener() {
                public void onProductDetailsResponse(BillingResult billingResult, List<ProductDetails> productDetailsList) {
                    // Process the result
                }
        }
);

Callback สำหรับ queryProductDetailsAsync จะแสดงผลเป็น List<ProductDetails> รายการ ProductDetails แต่ละรายการจะมีข้อมูลเกี่ยวกับผลิตภัณฑ์ (รหัส ชื่อ ประเภท และอื่นๆ) ความแตกต่างหลักคือตอนนี้ผลิตภัณฑ์ที่ต้องสมัครใช้บริการยังมี List<ProductDetails.SubscriptionOfferDetails> ซึ่งมีข้อเสนอทั้งหมดที่ผู้ใช้ใช้ได้ด้วย

เนื่องจาก Play Billing Library เวอร์ชันก่อนหน้าไม่รองรับออบเจ็กต์ใหม่ (การสมัครใช้บริการ แพ็กเกจเริ่มต้น ข้อเสนอ และอื่นๆ) ระบบใหม่จึงแปล SKU การสมัครใช้บริการแต่ละรายการเป็นแพ็กเกจเริ่มต้นและข้อเสนอที่เข้ากันได้แบบย้อนหลังรายการเดียว ระบบจะย้ายผลิตภัณฑ์แบบซื้อครั้งเดียวที่พร้อมจำหน่ายไปยังออบเจ็กต์ ProductDetails ด้วย คุณเข้าถึงรายละเอียดข้อเสนอของผลิตภัณฑ์ที่ซื้อแบบครั้งเดียวได้ด้วยเมธอด getOneTimePurchaseOfferDetails()

ในบางกรณีซึ่งเกิดขึ้นไม่บ่อยนัก อุปกรณ์บางเครื่องอาจไม่รองรับ ProductDetails และ queryProductDetailsAsync() ซึ่งมักเกิดจากบริการ Google Play เป็นเวอร์ชันที่ล้าสมัย เพื่อให้มั่นใจว่ามีการรองรับสถานการณ์นี้อย่างเหมาะสม ให้เรียกใช้ isFeatureSupported() สำหรับฟีเจอร์ PRODUCT_DETAILS ก่อนเรียกใช้ queryProductDetailsAsync หากการตอบกลับเป็น OK แสดงว่าอุปกรณ์รองรับฟีเจอร์นี้และคุณสามารถโทรหา queryProductDetailsAsync() ได้ หากการตอบกลับคือ FEATURE_NOT_SUPPORTED คุณสามารถขอรายการผลิตภัณฑ์ที่เข้ากันได้แบบย้อนหลังซึ่งพร้อมใช้งานด้วย querySkuDetailsAsync() แทนได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ฟีเจอร์ความเข้ากันได้แบบย้อนหลังได้ที่คู่มือฟีเจอร์การสมัครใช้บริการเดือนพฤษภาคม 2022

เปิดขั้นตอนการซื้อข้อเสนอ

การเปิดตัวขั้นตอนการซื้อสำหรับข้อเสนอจะคล้ายกับการเปิดตัวขั้นตอนสำหรับ SKU เป็นอย่างมาก หากต้องการเริ่มคำขออนุมัติการซื้อโดยใช้เวอร์ชัน 6 ให้ทำดังนี้

  • ใช้ ProductDetailsParams แทน SkuDetails สำหรับ BillingFlowParams
  • คุณดูรายละเอียดข้อเสนอ เช่น รหัสข้อเสนอ รหัสแพ็กเกจเริ่มต้น และอื่นๆ ได้โดยใช้ออบเจ็กต์ SubscriptionOfferDetails

หากต้องการซื้อผลิตภัณฑ์ด้วยข้อเสนอที่ผู้ใช้เลือก ให้รับ offerToken ของข้อเสนอที่เลือกและส่งไปยังออบเจ็กต์ ProductDetailsParams

เมื่อสร้างออบเจ็กต์ BillingFlowParams แล้ว การเปิดใช้โฟลว์การเรียกเก็บเงินด้วย BillingClient จะยังคงเหมือนเดิม

ตัวอย่างต่อไปนี้แสดงลักษณะของแอปก่อนและหลังทำการเปลี่ยนแปลงเหล่านี้

ก่อน

Kotlin

// An activity reference from which the billing flow will be launched.
val activity : Activity = ...
// Retrieve a value for "skuDetails" by calling querySkuDetailsAsync().
val billingFlowParams = BillingFlowParams.newBuilder()
                            .setSkuDetails(skuDetails)
                            .build()

val billingResult = billingClient.launchBillingFlow(activity, billingFlowParams)

Java

// An activity reference from which the billing flow will be launched.
Activity activity = ...;
// Retrieve a value for "skuDetails" by calling querySkuDetailsAsync().
BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
        .setSkuDetails(skuDetails)
        .build();

BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams)

หลัง

Kotlin

// An activity reference from which the billing flow will be launched.
val activity : Activity = ...;

val productDetailsParamsList = listOf(
    BillingFlowParams.ProductDetailsParams.newBuilder()
        // retrieve a value for "productDetails" by calling queryProductDetailsAsync()
        .setProductDetails(productDetails)
        // For One-time product, "setOfferToken" method shouldn't be called.
        // For subscriptions, to get the offer token corresponding to the selected
        // offer call productDetails.subscriptionOfferDetails?.get(selectedOfferIndex)?.offerToken
        .setOfferToken(selectedOfferToken)
        .build()
)

val billingFlowParams = BillingFlowParams.newBuilder()
    .setProductDetailsParamsList(productDetailsParamsList)
    .build()

// Launch the billing flow
val billingResult = billingClient.launchBillingFlow(activity, billingFlowParams)

Java

// An activity reference from which the billing flow will be launched.
Activity activity = ...;

ImmutableList<ProductDetailsParams> productDetailsParamsList =
    ImmutableList.of(
        ProductDetailsParams.newBuilder()
             // retrieve a value for "productDetails" by calling queryProductDetailsAsync()
            .setProductDetails(productDetails)
            // For one-time products, "setOfferToken" method shouldn't be called.
            // For subscriptions, to get the offer token corresponding to the selected
            // offer call productDetails.getSubscriptionOfferDetails().get(selectedOfferIndex).getOfferToken()
            .setOfferToken(selectedOfferToken)
            .build()
    );

BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
    .setProductDetailsParamsList(productDetailsParamsList)
    .build();

// Launch the billing flow
BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);

ประมวลผลการซื้อ

การประมวลผลการซื้อด้วย Google Play Billing Library 6 ยังคงคล้ายกับเวอร์ชันก่อนหน้า

หากต้องการดึงข้อมูลการซื้อที่ใช้งานอยู่ทั้งหมดของผู้ใช้และค้นหาการซื้อใหม่ ให้ทำดังนี้

  • แทนที่จะส่งค่า BillingClient.SkuType ไปยัง queryPurchasesAsync() ให้ส่งออบเจ็กต์ QueryPurchasesParams ที่มีค่า BillingClient.ProductType แทน

ตัวอย่างต่อไปนี้แสดงลักษณะของแอปก่อนและหลังทำการเปลี่ยนแปลงเหล่านี้

ก่อน

Kotlin

billingClient.queryPurchasesAsync(BillingClient.SkuType.SUBS) {
    billingResult,
    purchaseList -> {
        // Process the result
    }
}

Java

billingClient.queryPurchasesAsync(
    BillingClient.SkuType.SUBS,
    new PurchasesResponseListener() {
        public void onQueryPurchasesResponse(
                BillingResult billingResult,
                List<Purchase> purchases) {
            // process the result
        }
    }
);

หลัง

Kotlin

billingClient.queryPurchasesAsync(
    QueryPurchasesParams.newBuilder()
        .setProductType(BillingClient.ProductType.SUBS)
        .build()
) { billingResult, purchaseList ->
    // Process the result
}

Java

billingClient.queryPurchasesAsync(
    QueryPurchasesParams.newBuilder().setProductType(ProductType.SUBS).build(),
    new PurchasesResponseListener() {
        public void onQueryPurchasesResponse(
                BillingResult billingResult,
                List<Purchase> purchases) {
            // Process the result
        }
    }
);

ขั้นตอนในการจัดการการซื้อนอกแอปและธุรกรรมที่รอดำเนินการยังคงเหมือนเดิม

จัดการสถานะการซื้อการสมัครใช้บริการด้วย API ใหม่ในแบ็กเอนด์

คุณควรย้ายข้อมูลคอมโพเนนต์การจัดการสถานะการซื้อการสมัครใช้บริการในแบ็กเอนด์เพื่อให้พร้อมจัดการการซื้อผลิตภัณฑ์ใหม่ที่สร้างขึ้นในขั้นตอนก่อนหน้า คอมโพเนนต์การจัดการสถานะการซื้อการสมัครใช้บริการปัจจุบันควรทำงานตามปกติสำหรับผลิตภัณฑ์ที่ต้องสมัครใช้บริการที่แปลงแล้วซึ่งคุณกำหนดไว้ก่อนการเปิดตัวในเดือนพฤษภาคม 2022 และควรเพียงพอที่จะจัดการการซื้อข้อเสนอที่เข้ากันได้แบบย้อนหลัง แต่จะไม่รองรับฟังก์ชันใหม่ๆ

คุณต้องใช้ Subscription Purchases API ใหม่สำหรับโมดูลการจัดการสถานะการซื้อการสมัครใช้บริการ ซึ่งจะตรวจสอบสถานะการซื้อและจัดการสิทธิ์การสมัครใช้บริการ Google Play Billing ในแบ็กเอนด์ เวอร์ชันเก่าของ API ไม่แสดงรายละเอียดที่จำเป็นทั้งหมดในการจัดการการซื้อในแพลตฟอร์มใหม่ ดูรายละเอียดเกี่ยวกับการเปลี่ยนแปลงจากเวอร์ชันก่อนหน้าได้ที่คู่มือฟีเจอร์ใหม่สำหรับการสมัครใช้บริการในเดือนพฤษภาคม 2022

เมื่อย้ายข้อมูลโมดูลการจัดการสถานะการซื้อ ให้ทำดังนี้

ปลายทางใหม่นี้จะแสดงสถานะของผลิตภัณฑ์ที่ต้องสมัครใช้บริการและการซื้อทั้งหมด ไม่ว่าแอปเวอร์ชันใดจะขายผลิตภัณฑ์เหล่านั้นและไม่ว่าผลิตภัณฑ์จะได้รับการกำหนดเมื่อใด (ก่อนหรือหลังการเปิดตัวในเดือนพฤษภาคม 2022) ดังนั้นหลังจากการย้ายข้อมูล คุณจะต้องใช้โมดูลการจัดการสถานะการซื้อการสมัครใช้บริการเวอร์ชันนี้เท่านั้น

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

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

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

เราได้นำ launchPriceConfirmationFlow API ที่เลิกใช้งานก่อนหน้านี้ออกจาก Play Billing Library 6 แล้ว ดูทางเลือกอื่นๆ ได้ที่คู่มือการเปลี่ยนแปลงราคา

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

ใน Play Billing Library 6 มีการเพิ่มรหัส NETWORK_ERROR ใหม่เพื่อระบุปัญหาเกี่ยวกับการเชื่อมต่อเครือข่ายระหว่างอุปกรณ์ของผู้ใช้กับระบบ Google Play นอกจากนี้ยังมีการเปลี่ยนแปลงรหัส SERVICE_TIMEOUT และ SERVICE_UNAVAILABLE ด้วย ดูข้อมูลเพิ่มเติมได้ที่จัดการโค้ดตอบกลับ BillingResult

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

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