เอกสารนี้อธิบายวิธีย้ายข้อมูลจาก 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
เมื่อย้ายข้อมูลโมดูลการจัดการสถานะการซื้อ ให้ทำดังนี้
- เรียกใช้ Subscription Purchases API ทุกครั้งที่คุณได้รับการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป
SubscriptionNotificationเพื่อดึงข้อมูลล่าสุดเกี่ยวกับสถานะการสมัครใช้บริการ - แทนที่การเรียก
purchases.subscriptions.getด้วย Subscription Purchases API เวอร์ชันใหม่purchases.subscriptionsv2.get - ใช้ทรัพยากร
SubscriptionPurchaseV2ใหม่ ซึ่งให้ข้อมูลเพียงพอในการจัดการสิทธิ์การซื้อสำหรับการสมัครใช้บริการในรูปแบบใหม่
ปลายทางใหม่นี้จะแสดงสถานะของผลิตภัณฑ์ที่ต้องสมัครใช้บริการและการซื้อทั้งหมด ไม่ว่าแอปเวอร์ชันใดจะขายผลิตภัณฑ์เหล่านั้นและไม่ว่าผลิตภัณฑ์จะได้รับการกำหนดเมื่อใด (ก่อนหรือหลังการเปิดตัวในเดือนพฤษภาคม 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 และคู่มือการจัดการวงจรการซื้อ