เอกสารนี้แสดงรายการและอธิบายขั้นตอนการตั้งค่าที่คุณต้องทำก่อนจึงจะขายผลิตภัณฑ์ในแอปได้ โดยภาพรวมแล้ว การตั้งค่านี้รวมถึงการสร้างบัญชีนักพัฒนาแอป การสร้างและกำหนดค่าผลิตภัณฑ์ที่ต้องการขาย ตลอดจนการเปิดใช้และกำหนดค่า API ที่คุณใช้เพื่อขายและจัดการผลิตภัณฑ์ เอกสารนี้ยังอธิบายวิธีกำหนดค่าการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปเพื่อรับการแจ้งเตือนเมื่อสถานะของผลิตภัณฑ์มีการเปลี่ยนแปลงด้วย
ตั้งค่าบัญชีนักพัฒนาแอป Google Play
หากต้องการเผยแพร่แอปและเกมใน Google Play ให้ใช้ Google Play Console นอกจากนี้ คุณยังใช้ Google Play Console เพื่อจัดการผลิตภัณฑ์และการตั้งค่าที่เกี่ยวข้องกับการเรียกเก็บเงินด้วย
หากต้องการเข้าถึง Google Play Console คุณต้องตั้งค่าบัญชีนักพัฒนาแอป Google Play
หากต้องการขายแอปที่ต้องซื้อและการซื้อในแอปใน Google Play คุณต้องตั้งค่าโปรไฟล์ในศูนย์การชำระเงินของ Google ด้วย จากนั้นลิงก์โปรไฟล์ดังกล่าวกับบัญชีนักพัฒนาแอป Google Play ดูวิธีลิงก์โปรไฟล์กับบัญชี หรือดูวิธีตรวจสอบว่าคุณมีบัญชีและโปรไฟล์ที่ลิงก์อยู่แล้วหรือไม่ที่หัวข้อลิงก์บัญชีนักพัฒนาแอป Google Play กับโปรไฟล์การชำระเงิน
เปิดใช้ฟีเจอร์ที่เกี่ยวข้องกับการเรียกเก็บเงินใน Google Play Console
เมื่อตั้งค่าบัญชีนักพัฒนาแอปแล้ว คุณต้องเผยแพร่แอปเวอร์ชันที่มี Google Play Billing Library ขั้นตอนนี้จำเป็นสำหรับการเปิดใช้ฟีเจอร์ที่เกี่ยวข้องกับการเรียกเก็บเงินใน Google Play Console เช่น การกำหนดค่าผลิตภัณฑ์ที่คุณต้องการขาย
เพิ่มทรัพยากร Dependency ของไลบรารี
หากต้องการผสานรวมระบบการเรียกเก็บเงินของ Google Play ก่อนอื่นให้เพิ่มทรัพยากร Dependency ลงใน Google Play Billing Library ในแอปของคุณ ไลบรารีนี้ให้สิทธิ์เข้าถึง Android API ที่เชื่อมต่อคุณกับ Google Play จากนั้นคุณจะเข้าถึงข้อมูลการซื้อ ค้นหาข้อมูลอัปเดตเกี่ยวกับการซื้อ แจ้งให้ผู้ใช้ทำการซื้อใหม่ และอื่นๆ ได้
Google Play Billing Library พร้อมให้บริการจากที่เก็บ Maven ของ Google เพิ่มทรัพยากร Dependency ลงในไฟล์ build.gradle ของแอปดังที่แสดงด้านล่าง
Groovy
dependencies { def billing_version = "9.1.0" implementation "com.android.billingclient:billing:$billing_version" }
Kotlin
dependencies { val billing_version = "9.1.0" implementation("com.android.billingclient:billing:$billing_version") }
หากคุณใช้ Kotlin โมดูล KTX ของ Play Billing Library จะมีส่วนขยาย Kotlin และการรองรับ Coroutine ที่ช่วยให้คุณเขียน Kotlin ตามสำนวนได้เมื่อใช้ระบบการเรียกเก็บเงินของ Google Play หากต้องการรวมส่วนขยายเหล่านี้ในโปรเจ็กต์ ให้เพิ่มทรัพยากร Dependency ต่อไปนี้ลงในไฟล์ build.gradle ของแอปตามที่แสดง
Groovy
dependencies { def billing_version = "9.1.0" implementation "com.android.billingclient:billing-ktx:$billing_version" }
Kotlin
dependencies { val billing_version = "9.1.0" implementation("com.android.billingclient:billing-ktx:$billing_version") }
ตัวอย่างโค้ด Kotlin ที่พบในหน้านี้ใช้ประโยชน์จาก KTX หากเป็นไปได้
อัปโหลดแอป
เมื่อเพิ่มไลบรารีลงในแอปแล้ว ให้สร้างและเผยแพร่แอป สำหรับขั้นตอนนี้ ให้สร้างแอปแล้วเผยแพร่ไปยังแทร็กใดก็ได้ รวมถึงแทร็กทดสอบภายใน
สร้างและกำหนดค่าผลิตภัณฑ์
หลังจากเปิดใช้ฟีเจอร์ Google Play Billing สำหรับแอปแล้ว คุณต้องกำหนดค่าผลิตภัณฑ์ที่จะขาย
ขั้นตอนในการสร้างผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวและการสมัครใช้บริการจะคล้ายกัน คุณต้องระบุรหัสสินค้า, ชื่อ, รายละเอียด และข้อมูลราคาที่ไม่ซ้ำกันสำหรับสินค้าแต่ละรายการ การสมัครใช้บริการมีข้อมูลที่จำเป็นเพิ่มเติม เช่น การเลือกว่าเป็นประเภทการต่ออายุใหม่อัตโนมัติหรือชำระล่วงหน้าสำหรับแพ็กเกจเริ่มต้น
Google Play Console มีอินเทอร์เฟซเว็บที่คุณใช้จัดการผลิตภัณฑ์ได้
หากต้องการสร้างและกำหนดค่าผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว โปรดดูสร้างผลิตภัณฑ์ที่มีการจัดการ โปรดทราบว่า Google Play Console จะเรียกผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวว่าผลิตภัณฑ์ที่มีการจัดการ
หากต้องการสร้างและกำหนดค่าการสมัครใช้บริการ โปรดดูหัวข้อสร้างการสมัครใช้บริการ
นอกเหนือจากอินเทอร์เฟซเว็บแล้ว คุณยังจัดการผลิตภัณฑ์ได้โดยใช้ทรัพยากร REST inappproducts สำหรับไอเทมที่ซื้อในแอป และทรัพยากร REST monetization.subscriptions สำหรับผลิตภัณฑ์ที่ต้องสมัครใช้บริการใน Google Play Developer API
กำหนดค่า Google Play Developer API
Google Play Developer API เป็น API แบบเซิร์ฟเวอร์ถึงเซิร์ฟเวอร์ที่เสริมการทำงานของ Google Play Billing Library ใน Android API นี้มีฟังก์ชันการทำงานที่ไม่มีใน Google Play Billing Library เช่น การยืนยันการซื้ออย่างปลอดภัยและการคืนเงินให้แก่ผู้ใช้
ในการผสานรวมระบบการเรียกเก็บเงินของ Google Play ไว้ในแอป คุณต้องกำหนดค่าการเข้าถึง Google Play Developer API ผ่าน Google Play Console ดูวิธีการได้ที่การเริ่มต้นใช้งาน Google Play Developer API
เมื่อกำหนดค่าสิทธิ์เข้าถึง Google Play Developer API แล้ว ให้ตรวจสอบว่าคุณได้ให้สิทธิ์ดูข้อมูลทางการเงิน ซึ่งจำเป็นสำหรับการเข้าถึงฟังก์ชันการทำงานที่เกี่ยวข้องกับการเรียกเก็บเงิน ดูข้อมูลเกี่ยวกับแนวทางปฏิบัติแนะนำ รวมถึงข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าสิทธิ์ได้ที่เพิ่มผู้ใช้บัญชีนักพัฒนาแอปและจัดการสิทธิ์
กำหนดค่าการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป
การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป (RTDN) เป็นกลไกในการรับการแจ้งเตือนจาก Google เมื่อใดก็ตามที่มีการเปลี่ยนแปลงสิทธิ์ของผู้ใช้ภายในแอปของคุณ RTDN ใช้ Google Cloud Pub/Sub ซึ่งช่วยให้คุณได้รับข้อมูลที่พุชไปยัง URL ที่คุณตั้งค่าไว้หรือทำการสำรวจโดยใช้ไลบรารีของไคลเอ็นต์ การแจ้งเตือนเหล่านี้ช่วยให้คุณตอบสนองต่อการเปลี่ยนแปลงสถานะการสมัครใช้บริการได้ทันที โดยไม่ต้องทำการสำรวจ Google Play Developer API โปรดทราบว่าการใช้ Google Play Developer API อย่างไม่มีประสิทธิภาพอาจทำให้เกิดข้อจำกัดโควต้า API
Cloud Pub/Sub คือบริการรับส่งข้อความแบบเรียลไทม์ที่มีการจัดการครบวงจรซึ่งคุณสามารถใช้เพื่อรับส่งข้อความระหว่างแอปพลิเคชันต่างๆ ที่เป็นอิสระจากกัน Google Play ใช้ Cloud Pub/Sub เพื่อเผยแพร่ข้อความ Push ในหัวข้อที่คุณสมัครรับข้อมูล
หากต้องการรับการแจ้งเตือน คุณต้องสร้างเซิร์ฟเวอร์แบ็กเอนด์เพื่อใช้ข้อความที่ส่งไปยังหัวข้อของคุณ จากนั้นเซิร์ฟเวอร์ของคุณจะใช้ข้อความเหล่านี้ได้โดยการตอบกลับคำขอ HTTPS ไปยังปลายทางที่ลงทะเบียนไว้หรือใช้ไลบรารีของไคลเอ็นต์ Cloud Pub/Sub ไลบรารีเหล่านี้มีให้บริการในหลายภาษา และยังดูข้อมูลเพิ่มเติมได้จากส่วนสร้างการสมัครใช้บริการ Pub/Sub ในเอกสารนี้
กำหนดราคาและโควต้า
ดูรายละเอียดเกี่ยวกับราคาและโควต้าได้ที่ราคาและโควต้า
ประเมินปริมาณการใช้อินเทอร์เน็ต
ส่วนข้อมูลของการแจ้งเตือนการสมัครใช้บริการมีขนาดประมาณ 1 KB ต่อคำขอ การเผยแพร่และการดึงข้อมูลแต่ละครั้งต้องใช้คำขอแยกกัน หรือข้อมูลประมาณ 2 KB ต่อการแจ้งเตือน จำนวนการแจ้งเตือนต่อเดือนจะขึ้นอยู่กับรอบการเรียกเก็บเงินและพฤติกรรมของผู้ใช้ คุณควรได้รับการแจ้งเตือนอย่างน้อย 1 ครั้งสำหรับผู้ใช้แต่ละรายในรอบการเรียกเก็บเงิน
ตั้งค่า Cloud Pub/Sub
หากต้องการเปิดใช้การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป คุณต้องตั้งค่า Cloud Pub/Sub โดยใช้โปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google เองก่อน แล้วจึงเปิดใช้การแจ้งเตือนสำหรับแอป
หากต้องการใช้ Cloud Pub/Sub คุณต้องมีโปรเจ็กต์ Google Cloud ที่เปิดใช้ Cloud Pub/Sub API หากคุณไม่คุ้นเคยกับ Google Cloud และ Cloud Pub/Sub โปรดดูคู่มือเริ่มใช้งานฉบับย่อ
สร้างหัวข้อ
หากต้องการเริ่มรับการแจ้งเตือน คุณต้องสร้างหัวข้อที่ Google Play ควรเผยแพร่การแจ้งเตือน หากต้องการสร้างหัวข้อ ให้ทำตามวิธีการในหัวข้อสร้างหัวข้อ
สร้างการสมัครใช้บริการ Pub/Sub
หากต้องการรับข้อความที่เผยแพร่ไปยังหัวข้อ คุณต้องสร้างการสมัครใช้บริการ Pub/Sub สำหรับหัวข้อนั้น หากต้องการสร้างการสมัครใช้บริการ Pub/Sub ให้ทำดังนี้
- อ่านคู่มือสำหรับผู้สมัครใช้บริการ Cloud Pub/Sub เพื่อพิจารณาว่าจะกำหนดค่าการสมัครใช้บริการเป็นการสมัครใช้บริการแบบพุชหรือการสมัครใช้บริการแบบพุล
- การสมัครใช้บริการแบบพุชช่วยให้ Cloud Pub/Sub ส่งการแจ้งเตือนไปยังแบ็กเอนด์ที่ปลอดภัยของคุณได้โดยการส่งคำขอ HTTPS
- การสมัครใช้บริการแบบพุลกำหนดให้เซิร์ฟเวอร์แบ็กเอนด์ที่ปลอดภัยของคุณต้องเริ่มส่งคำขอไปยังเซิร์ฟเวอร์ Cloud Pub/Sub เพื่อดึงข้อความ
- ทำตามวิธีการในหัวข้อเพิ่มการสมัครใช้บริการเพื่อสร้างการสมัครใช้บริการ
ให้สิทธิ์ในการเผยแพร่ในหัวข้อของคุณ
Cloud Pub/Sub กำหนดให้คุณต้องให้สิทธิ์ Google Play ในการเผยแพร่การแจ้งเตือนไปยังหัวข้อของคุณ
- เปิดคอนโซล Google Cloud
- เลือกโปรเจ็กต์ แล้วคลิก Pub/Sub ในการนำทางด้านซ้ายมือ
ค้นหาหัวข้อที่ต้องการ แล้วเปิดรายละเอียดสิทธิ์
รูปที่ 1 การเข้าถึงการกำหนดค่าสำหรับหัวข้อสิทธิ์ เพิ่มบัญชีบริการ
google-play-developer-notifications@system.gserviceaccount.comและ มอบบทบาท Pub/Sub Publisher ให้กับบัญชีดังกล่าว
รูปที่ 2 กำลังเพิ่มบัญชีบริการ Google Play เป็นผู้เผยแพร่ Pub/Sub คลิกบันทึกเพื่อตั้งค่าหัวข้อให้เสร็จสมบูรณ์
รูปที่ 3 หัวข้อที่กำหนดค่าไว้
เปิดใช้การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปสำหรับแอปของคุณ
หากต้องการเปิดใช้การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป ให้ทำดังนี้
- เปิด Google Play Console
- เลือกแอป
- ไปที่สร้างรายได้ > การตั้งค่าการสร้างรายได้
ไปที่ส่วนการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปที่ด้านบนของหน้า
รูปที่ 4 การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป ส่วน เลือกเปิดใช้การแจ้งเตือนแบบเรียลไทม์
ในช่องชื่อหัวข้อ ให้ป้อนชื่อหัวข้อ Cloud Pub/Sub แบบเต็มที่คุณกำหนดค่าไว้ก่อนหน้านี้ ชื่อหัวข้อควรอยู่ในรูปแบบ
projects/{project_id}/topics/{topic_name}โดยที่project_idคือตัวระบุที่ไม่ซ้ำกันสำหรับโปรเจ็กต์ และtopic_nameคือชื่อของหัวข้อที่สร้างไว้ก่อนหน้านี้คลิกส่งข้อความทดสอบเพื่อส่งข้อความทดสอบ การทดสอบการเผยแพร่จะช่วยให้มั่นใจได้ว่าทุกอย่างได้รับการตั้งค่าและกำหนดค่าอย่างถูกต้อง หากการเผยแพร่ทดสอบสำเร็จ ระบบจะแสดงข้อความที่ระบุว่าการเผยแพร่ทดสอบสำเร็จ หากคุณแนบการสมัครใช้บริการสำหรับหัวข้อนี้ไว้ คุณควรได้รับข้อความทดสอบ
สำหรับการสมัครใช้บริการแบบพุล ให้ไปที่การสมัครใช้บริการใน Cloud Console แล้วคลิกดูข้อความ จากนั้นดำเนินการพุลข้อความ คุณควรตอบรับข้อความที่ดึงมาเพื่อหลีกเลี่ยงการส่งซ้ำโดย Cloud Pub/Sub สำหรับการสมัครใช้บริการแบบพุช ให้ตรวจสอบว่าข้อความทดสอบส่งไปยังปลายทางพุชหรือไม่ โค้ดตอบกลับที่สำเร็จจะทำหน้าที่เป็นข้อความตอบรับ
หากเผยแพร่ไม่สำเร็จ ระบบจะแสดงข้อผิดพลาด ตรวจสอบว่าชื่อหัวข้อถูกต้องและบัญชีบริการ
google-play-developer-notifications@system.gserviceaccount.comมีสิทธิ์เข้าถึงหัวข้อในฐานะผู้เผยแพร่ Pub/Subเลือกประเภทการแจ้งเตือนที่ต้องการรับ
- รับการแจ้งเตือนสำหรับการสมัครใช้บริการและการซื้อที่เป็นโมฆะทั้งหมด - รับการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปที่เกี่ยวข้องกับการสมัครใช้บริการและการซื้อที่เป็นโมฆะ คุณจะไม่ได้รับการแจ้งเตือนสำหรับการซื้อผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว
- รับการแจ้งเตือนทั้งหมดสำหรับการสมัครใช้บริการและผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว - รับการแจ้งเตือนสำหรับเหตุการณ์การสมัครใช้บริการและเหตุการณ์การซื้อที่เป็นโมฆะทั้งหมด
นอกจากนี้ คุณยังจะได้รับเหตุการณ์การซื้อผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว เช่น
ONE_TIME_PRODUCT_PURCHASEDและONE_TIME_PRODUCT_CANCELEDด้วย ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์การซื้อเหล่านี้ได้ที่วงจรการซื้อครั้งเดียว
คลิกบันทึกการเปลี่ยนแปลง
กำลังยืนยันการกำหนดค่า
หากต้องการรับการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป คุณควรสร้างเซิร์ฟเวอร์แบ็กเอนด์ที่ปลอดภัยเพื่อใช้ข้อความที่ส่งไปยังหัวข้อ Cloud Pub/Sub
คุณทดสอบการกำหนดค่าได้โดยใช้ปุ่มส่งข้อความทดสอบใน Google Play Console ตามที่อธิบายไว้ในส่วนก่อนหน้า หากยังไม่ได้กำหนดค่าเซิร์ฟเวอร์แบ็กเอนด์เพื่อใช้การแจ้งเตือน คุณสามารถใช้เครื่องมือบรรทัดคำสั่ง gcloud เพื่อยืนยันการกำหนดค่าได้ ดูวิธีการประมวลผลข้อความโดยใช้ gcloud ได้ที่หัวข้อดึงข้อความจากการสมัครใช้บริการ