ระบบการเรียกเก็บเงินของ Google Play เป็นบริการที่เปิดโอกาสให้คุณขายผลิตภัณฑ์และเนื้อหาดิจิทัลในแอป Android โดยในรุ่นเดือนพฤษภาคม 2022 เราได้เปลี่ยนวิธีกำหนดผลิตภัณฑ์ที่ต้องสมัครใช้บริการ ซึ่งส่งผลต่อวิธีขายผลิตภัณฑ์ดังกล่าวในแอปและวิธีจัดการในแบ็กเอนด์ หากคุณผสานรวมกับ Google Play Billing เป็นครั้งแรก คุณสามารถเริ่มการผสานรวมได้โดยอ่านการเตรียมพร้อม
หากคุณขายการสมัครใช้บริการด้วย Google Play Billing ก่อนเดือนพฤษภาคม 2022 คุณควรทำความเข้าใจวิธีใช้ฟีเจอร์ใหม่ๆ ขณะที่ยังคงรักษาการสมัครใช้บริการที่มีอยู่ไว้
สิ่งแรกที่ควรทราบคือการสมัครใช้บริการ แอป และการผสานรวมแบ็กเอนด์ที่มีอยู่ทั้งหมดจะทํางานเหมือนก่อนการเปิดตัวในเดือนพฤษภาคม 2022 คุณไม่จำเป็นต้องทำการเปลี่ยนแปลงใดๆ ในทันที และสามารถใช้ฟีเจอร์ใหม่เหล่านี้ได้ทุกเวลาที่ต้องการ Google Play Billing Library แต่ละรุ่นหลักจะได้รับการสนับสนุนเป็นเวลา 2 ปีหลังจากเปิดตัว การผสานรวมที่มีอยู่กับ Google Play Developer API จะยังคงทำงานเหมือนเดิม
ภาพรวมของการอัปเดตในเดือนพฤษภาคม 2022 มีดังนี้
- Google Play Console ใหม่ช่วยให้คุณสร้างและจัดการการสมัครใช้บริการ แพ็กเกจเริ่มต้น และข้อเสนอได้ ซึ่งรวมถึงการสมัครใช้บริการทั้งใหม่และที่ย้ายข้อมูลแล้ว
- Play Developer API มีการอัปเดตเพื่อรองรับฟังก์ชันการทำงานใหม่ของ UI ใน Google Play Console ในรูปแบบ API โดยเฉพาะอย่างยิ่ง Subscription Purchases API เวอร์ชันใหม่ ใช้ API นี้เพื่อตรวจสอบสถานะการสมัครใช้บริการและจัดการการซื้อการสมัครใช้บริการ
- Play Billing Library เวอร์ชัน 5 ใหม่ช่วยให้แอปของคุณได้รับประโยชน์จากฟีเจอร์การสมัครใช้บริการใหม่ทั้งหมด เมื่อพร้อมอัปเกรดเป็นเวอร์ชัน 5 ให้ทำตามคำแนะนำในคำแนะนำในการย้ายข้อมูล
การกำหนดค่าการสมัครใช้บริการ
การจัดการการสมัครใช้บริการโดยใช้ Google Play Console
ตั้งแต่เดือนพฤษภาคม 2022 เป็นต้นไป คุณจะสังเกตเห็นความแตกต่างบางอย่างใน Google Play Console
ตอนนี้การสมัครใช้บริการหนึ่งๆ สามารถมีแพ็กเกจเริ่มต้นและข้อเสนอได้หลายแบบ ตอนนี้ SKU การสมัครใช้บริการที่สร้างไว้ก่อนหน้านี้จะปรากฏใน Play Console เป็นออบเจ็กต์การสมัครใช้บริการ แพ็กเกจเริ่มต้น และข้อเสนอใหม่เหล่านี้ หากยังไม่ได้อ่าน โปรดดูคำอธิบายออบเจ็กต์ใหม่ รวมถึงฟังก์ชันการทำงานและการกำหนดค่าในการเปลี่ยนแปลงล่าสุดในการสมัครใช้บริการใน Play Console ผลิตภัณฑ์ที่ต้องสมัครใช้บริการที่มีอยู่ก่อนทั้งหมดจะปรากฏใน Google Play Console ในรูปแบบใหม่นี้ ตอนนี้ SKU แต่ละรายการจะแสดงด้วยออบเจ็กต์การสมัครใช้บริการที่มีแพ็กเกจเริ่มต้นรายการเดียวและข้อเสนอที่เข้ากันได้แบบย้อนหลัง (หากมี)
เนื่องจากการผสานรวมที่เก่ากว่าคาดหวังให้การสมัครใช้บริการแต่ละรายการมีข้อเสนอเดียว ซึ่งแสดงด้วยออบเจ็กต์ SkuDetails การสมัครใช้บริการแต่ละรายการจึงมีแพ็กเกจเริ่มต้นหรือข้อเสนอที่เข้ากันได้แบบย้อนหลังเพียงรายการเดียว ระบบจะแสดงแพ็กเกจเริ่มต้นหรือข้อเสนอที่เข้ากันได้แบบย้อนหลังเป็นส่วนหนึ่งของ SKU สำหรับแอปที่ใช้วิธี querySkuDetailsAsync() ซึ่งเลิกใช้งานแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าและการจัดการข้อเสนอที่เข้ากันได้แบบย้อนหลังได้ที่หัวข้อทำความเข้าใจการสมัครใช้บริการ หลังจากที่แอปของคุณใช้เฉพาะ queryProductDetailsAsync() และหลังจากที่ไม่มีแอปเวอร์ชันก่อนหน้าทำการซื้ออีกต่อไป คุณก็ไม่จำเป็นต้องใช้ข้อเสนอที่เข้ากันได้แบบย้อนหลังอีก
การจัดการการสมัครใช้บริการด้วย Subscriptions Publishing API
Play Developer API มีฟังก์ชันใหม่สำหรับการซื้อการสมัครใช้บริการ API inappproducts สำหรับการจัดการ SKU จะยังคงทำงานเหมือนเดิม รวมถึงการจัดการผลิตภัณฑ์ที่ซื้อครั้งเดียวและการสมัครใช้บริการ คุณจึงไม่จำเป็นต้องทำการเปลี่ยนแปลงใดๆ ในทันทีเพื่อรักษาการผสานรวมไว้
อย่างไรก็ตาม โปรดทราบว่า Google Play Console จะใช้เฉพาะเอนทิตีการสมัครใช้บริการใหม่เท่านั้น หลังจากเริ่มแก้ไขการสมัครใช้บริการใน Console แล้ว คุณจะใช้ inappproducts API สำหรับการสมัครใช้บริการไม่ได้อีกต่อไป
หากคุณเคยใช้ Publishing API ก่อนเดือนพฤษภาคม 2022 การสมัครใช้บริการที่มีอยู่จะปรากฏเป็นแบบอ่านอย่างเดียวใน Google Play Console เพื่อหลีกเลี่ยงปัญหา
หากพยายามทำการเปลี่ยนแปลง คุณอาจได้รับคำเตือนที่อธิบายข้อจำกัดนี้
ก่อนแก้ไขการสมัครใช้บริการเพิ่มเติมใน Console คุณควรอัปเดตการผสานรวมแบ็กเอนด์เพื่อใช้ปลายทางการเผยแพร่การสมัครใช้บริการใหม่ ปลายทางใหม่ monetization.subscriptions, monetization.subscriptions.baseplans และ monetization.subscriptions.offers ช่วยให้คุณจัดการแพ็กเกจเริ่มต้นและข้อเสนอทั้งหมดที่มีได้ คุณสามารถดูวิธีแมปช่องต่างๆ จากเอนทิตี InAppProduct ไปยังออบเจ็กต์ใหม่ใน monetization.subscriptions ได้ในตารางต่อไปนี้
| InAppProduct | การสมัครใช้บริการ |
|---|---|
packageName |
packageName |
sku |
productId |
status |
basePlans[0].state |
prices |
basePlans[0].regionalConfigs.price |
listings |
listings |
defaultPrice |
ไม่มีความเท่าเทียม |
subscriptionPeriod |
basePlans[0].autoRenewingBasePlanType.billingPeriodDuration |
trialPeriod |
basePlans[0].offers[0].phases[0].regionalConfigs[0].free |
gracePeriod |
basePlans[0].autoRenewingBasePlanType.gracePeriodDuration |
subscriptionTaxesAndComplianceSettings |
taxAndComplianceSettings |
การอัปเดต API ที่จำเป็นนี้มีผลกับ Publishing API (การจัดการ SKU) เท่านั้น
การเปลี่ยนแปลงใน Play Billing Library
Play Billing Library มีเมธอดและออบเจ็กต์ทั้งหมดที่พร้อมใช้งานในเวอร์ชันก่อนหน้าเพื่อรองรับการย้ายข้อมูลแบบค่อยเป็นค่อยไป ออบเจ็กต์และฟังก์ชัน SkuDetails เช่น querySkuDetailsAsync() ยังคงมีอยู่ คุณจึงอัปเกรดเพื่อใช้ฟังก์ชันใหม่ได้โดยไม่ต้องอัปเดตโค้ดการสมัครใช้บริการที่มีอยู่ทันที นอกจากนี้ คุณยังควบคุมได้ด้วยว่าข้อเสนอใดบ้างที่พร้อมให้บริการผ่านวิธีการเหล่านี้โดยทำเครื่องหมายข้อเสนอว่าเข้ากันได้แบบย้อนหลัง
นอกเหนือจากการเก็บเมธอดเดิมไว้แล้ว ตอนนี้ Play Billing Library 5 ยังมีออบเจ็กต์ ProductDetails ใหม่และเมธอด queryProductDetailsAsync() ที่เกี่ยวข้องเพื่อจัดการเอนทิตีและฟังก์ชันการทำงานใหม่ๆ ด้วย ตอนนี้ ProductDetails รองรับไอเทมที่ซื้อในแอปที่มีอยู่ (การซื้อครั้งเดียวและไอเทมที่ใช้แล้วหมดไป) ด้วย
สําหรับการสมัครใช้บริการ ProductDetails.getSubscriptionOfferDetails() จะแสดงรายการแพ็กเกจเริ่มต้นและข้อเสนอทั้งหมดที่ผู้ใช้มีสิทธิ์ซื้อ
ซึ่งหมายความว่าคุณจะเข้าถึงแพ็กเกจเริ่มต้นและข้อเสนอทั้งหมดที่มีสิทธิ์สำหรับผู้ใช้ได้ ไม่ว่าจะเข้ากันได้แบบย้อนหลังหรือไม่ก็ตาม
getSubscriptionOfferDetails() แสดงผลลัพธ์ null สำหรับผลิตภัณฑ์ที่ไม่ต้องสมัครใช้บริการ สำหรับการซื้อครั้งเดียว คุณสามารถใช้ getOneTimePurchaseOfferDetails() ได้
นอกจากนี้ Play Billing Library 5 ยังมีทั้งวิธีการใหม่และวิธีการเดิมสำหรับการเปิดขั้นตอนการซื้อด้วย หากออบเจ็กต์ BillingFlowParams ที่ส่งไปยัง BillingClient.launchBillingFlow() ได้รับการกำหนดค่าโดยใช้ออบเจ็กต์ SkuDetails ระบบจะดึงข้อมูลข้อเสนอที่จะขายจากแพ็กเกจเริ่มต้นหรือข้อเสนอที่เข้ากันได้แบบย้อนหลังซึ่งสอดคล้องกับ SKU หากออบเจ็กต์ BillingFlowParams ที่ส่งไปยัง BillingClient.launchBillingFlow() ได้รับการกำหนดค่าโดยใช้ออบเจ็กต์ ProductDetailsParams ซึ่งรวมถึง ProductDetails และ String ที่แสดงถึงโทเค็นข้อเสนอที่เฉพาะเจาะจงสำหรับข้อเสนอที่ซื้อ ระบบจะใช้ข้อมูลดังกล่าวเพื่อระบุผลิตภัณฑ์ที่ผู้ใช้ได้รับ
queryPurchasesAsync() จะแสดงผลการซื้อทั้งหมดที่ผู้ใช้เป็นเจ้าของ หากต้องการระบุประเภทสินค้าที่ขอ คุณสามารถส่งค่า BillingClient.SkuType เช่นเดียวกับในเวอร์ชันก่อนหน้า หรือออบเจ็กต์ QueryPurchasesParams ที่มีค่า BillingClient.ProductType ซึ่งแสดงถึงเอนทิตีการสมัครใช้บริการใหม่
เราขอแนะนำให้อัปเดตแอปเป็นไลบรารีเวอร์ชัน 5 โดยเร็วเพื่อให้คุณเริ่มใช้ประโยชน์จากฟีเจอร์การสมัครใช้บริการใหม่เหล่านี้ได้
การจัดการสถานะการสมัครใช้บริการ
ส่วนนี้จะอธิบายการเปลี่ยนแปลงหลักในคอมโพเนนต์แบ็กเอนด์ของการผสานรวมระบบการเรียกเก็บเงินของ Google Play ที่ต้องดำเนินการเพื่อย้ายข้อมูลไปยังเวอร์ชัน 5
การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป
ในเร็วๆ นี้ ออบเจ็กต์ SubscriptionNotification จะไม่มี subscriptionId อีกต่อไป หากคุณใช้ช่องนี้เพื่อระบุผลิตภัณฑ์ที่ต้องสมัครใช้บริการ คุณควรอัปเดตเพื่อรับข้อมูลนี้จากสถานะการสมัครใช้บริการโดยใช้ purchases.subscriptionsv2:get หลังจากได้รับการแจ้งเตือน องค์ประกอบ SubscriptionPurchaseLineItem แต่ละรายการในคอลเล็กชัน lineItems ที่แสดงผลเป็นส่วนหนึ่งของสถานะการซื้อจะมี productId ที่เกี่ยวข้อง
Subscriptions Purchases API: การดูสถานะการสมัครใช้บริการ
ใน Subscriptions Purchases API เวอร์ชันก่อนหน้า คุณสามารถค้นหาสถานะการสมัครใช้บริการได้โดยใช้ purchases.subscriptions:get
ปลายทางนี้ไม่มีการเปลี่ยนแปลงและยังคงทำงานสำหรับการซื้อการสมัครใช้บริการที่เข้ากันได้แบบย้อนหลัง ปลายทางนี้ไม่รองรับฟังก์ชันการทำงานใหม่ที่เปิดตัวในเดือนพฤษภาคม 2022
ใน Subscriptions Purchases API เวอร์ชันใหม่ ให้ใช้ purchases.subscriptionsv2:get เพื่อดูสถานะการซื้อการสมัครใช้บริการ
API นี้เข้ากันได้กับการสมัครใช้บริการที่ย้ายข้อมูล การสมัครใช้บริการใหม่ (ทั้งแบบชำระเงินล่วงหน้าและแบบต่ออายุใหม่อัตโนมัติ) และการซื้อทุกประเภท คุณสามารถใช้ปลายทางนี้เพื่อตรวจสอบสถานะการสมัครใช้บริการเมื่อได้รับการแจ้งเตือน ออบเจ็กต์ที่แสดงผล SubscriptionPurchaseV2 มีฟิลด์ใหม่ แต่ยังคงมีข้อมูลเดิมที่จำเป็นต่อการรองรับการสมัครใช้บริการที่มีอยู่ต่อไป
ฟิลด์ SubscriptionPurchaseV2 สำหรับแพ็กเกจแบบชำระเงินล่วงหน้า
ระบบได้เพิ่มช่องใหม่เพื่อรองรับแพ็กเกจแบบชำระเงินล่วงหน้า ซึ่งผู้ใช้จะขยายเวลาแทนการต่ออายุอัตโนมัติ ช่องทั้งหมดใช้กับแพ็กเกจแบบชำระเงินล่วงหน้าเช่นเดียวกับการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติ โดยมีข้อยกเว้นต่อไปนี้
- [ช่องใหม่]
lineItems[0].prepaid_plan.allowExtendAfterTime: ระบุเวลาที่ผู้ใช้จะได้รับอนุญาตให้ซื้อการเติมเงินอีกครั้งเพื่อขยายแพ็กเกจแบบชำระเงินล่วงหน้า เนื่องจากผู้ใช้จะได้รับอนุญาตให้มีการเติมเงินที่ยังไม่ได้ใช้เพียงครั้งละ 1 รายการเท่านั้น - [ช่องใหม่]
SubscriptionState: ระบุสถานะออบเจ็กต์การสมัครใช้บริการ สำหรับแพ็กเกจแบบชำระเงินล่วงหน้า ค่านี้จะเป็นACTIVE,PENDINGหรือCANCELEDเสมอ lineItems[0].expiryTime: ช่องนี้จะแสดงสำหรับแพ็กเกจแบบชำระเงินล่วงหน้าเสมอpaused_state_context: ช่องนี้จะไม่แสดงเนื่องจากแพ็กเกจแบบชำระเงินล่วงหน้าไม่สามารถหยุดชั่วคราวได้lineItems[0].auto_renewing_plan: ไม่มีสำหรับแพ็กเกจแบบชำระเงินล่วงหน้าcanceled_state_context: ไม่มีสำหรับแพ็กเกจแบบชำระเงินล่วงหน้า เนื่องจากช่องนี้ใช้กับผู้ใช้ที่ยกเลิกการสมัครใช้บริการอย่างสม่ำเสมอเท่านั้นlineItems[0].productId: ช่องนี้จะแทนที่subscriptionIdจากเวอร์ชันก่อนหน้า
ช่อง SubscriptionPurchaseV2 สำหรับการสมัครใช้บริการแบบตามรอบ
purchases.subscriptionsv2 มีฟิลด์ใหม่ที่ให้รายละเอียดเพิ่มเติมเกี่ยวกับออบเจ็กต์การสมัครใช้บริการใหม่ ตารางต่อไปนี้แสดงวิธีแมปช่องจากปลายทางการสมัครใช้บริการเดิมกับช่องที่เกี่ยวข้องใน purchases.subscriptionsv2
| SubscriptionPurchase | SubscriptionPurchaseV2 |
|---|---|
countryCode |
regionCode |
orderId |
latestOrderId |
| (ไม่มีช่องที่เทียบเท่า) | lineItems.offerPhase (ระบุเฟสปัจจุบัน: ช่วงทดลองใช้ฟรี, ราคาช่วงแนะนํา, การคิดตามสัดส่วน, ราคาฐาน) |
| (ไม่มีช่องที่เทียบเท่า) | lineItems (รายการของ SubscriptionPurchaseLineItem) ที่แสดงถึงผลิตภัณฑ์ที่ได้จากการซื้อ |
| (ไม่มีช่องที่เทียบเท่า) | lineItems.offerDetails.basePlanId |
| (ไม่มีช่องที่เทียบเท่า) | lineItems.offerDetails.offerId |
| (ไม่มีช่องที่เทียบเท่า) | lineItems.offerDetails.offerTags |
startTimeMillis |
startTime |
expiryTimeMillis |
lineItems.expiryTime (การสมัครใช้บริการแต่ละรายการที่ได้มาจากการซื้อจะมี expiryTime ของตัวเอง) |
| (ไม่มีช่องที่เทียบเท่า) | subscriptionState (ระบุสถานะของการสมัครใช้บริการ) |
| (ไม่มีช่องที่เทียบเท่า) | pausedStateContext (จะแสดงก็ต่อเมื่อสถานะการสมัครใช้บริการเป็น SUBSCRIPTION_STATE_PAUSED) |
autoResumeTimeMillis |
pausedStateContext.autoResumeTime |
| (ไม่มีช่องที่เทียบเท่า) | canceledStateContext (จะแสดงก็ต่อเมื่อสถานะการสมัครใช้บริการเป็น SUBSCRIPTION_STATE_CANCELED) |
| (ไม่มีช่องที่เทียบเท่า) | testPurchase (แสดงเฉพาะในการซื้อของผู้ทดสอบที่ได้รับอนุญาต) |
autoRenewing |
lineItems.autoRenewingPlan.autoRenewEnabled |
priceCurrenceCode
priceAmountMicros |
lineItems.autoRenewingPlan.recurringPrice |
introductoryPriceInfo |
lineItems.offerPhase.introductoryPriceคุณยังดูข้อมูลนี้ได้ใน offerสำหรับการสมัครใช้บริการแต่ละรายการที่ซื้อ |
| developerPayload | (ไม่มีช่องที่เทียบเท่า) ระบบเลิกใช้งานเพย์โหลดของนักพัฒนาแอปแล้ว |
| paymentState | (ไม่มีช่องที่เทียบเท่า) คุณสามารถอนุมานสถานะการชำระเงินได้จาก subscriptionState ดังนี้
|
cancelReason,
userCancellationTimeMillis,
cancelSurveyResult |
canceledStateContext |
linkedPurchaseToken |
linkedPurchaseToken (ไม่มีการเปลี่ยนแปลง) |
purchaseType |
ทดสอบ: จนถึงวันที่ testPurchaseโปรโมชัน: signupPromotion |
priceChange |
lineItems.autoRenewingPlan.priceChangeDetails |
profileName,
emailAddress,
givenName,
familyName,
profileId |
subscribeWithGoogleInfo |
acknowledgementState |
acknowledgementState (no change) |
promotionType
promotionCode |
signupPromotion |
externalAccountId,
obfuscatedExternalAccountId,
obfuscatedExteranlProfileId |
externalAccountIdentifiers |
ฟังก์ชันการจัดการการสมัครใช้บริการอื่นๆ
แม้ว่า purchases.subscriptions:get จะได้รับการอัปเกรดเป็น purchases.subscriptionsv2:get แล้ว แต่ฟังก์ชันการจัดการการสมัครใช้บริการของนักพัฒนาแอปที่เหลือจะยังคงเหมือนเดิมในปลายทาง purchases.subscriptions คุณจึงใช้ purchases.subscriptions:acknowledge, purchases.subscriptions:cancel, purchases.subscriptions:defer, purchases.subscriptions:refund และ purchases.subscriptions:revoke ได้ต่อไปเหมือนที่เคยทำ
Pricing API
ใช้ปลายทาง monetization.convertRegionPrices เพื่อคำนวณราคาระดับภูมิภาคเช่นเดียวกับที่คุณทำผ่าน Play Console วิธีนี้ยอมรับราคาเดียวในสกุลเงินที่ Play รองรับ และแสดงราคาที่แปลงแล้ว (รวมถึงอัตราภาษีเริ่มต้น หากมี) สำหรับภูมิภาคทั้งหมดที่ Google Play รองรับการซื้อ