การตั้งค่าบริการเกมของ Google Play

เอกสารนี้ครอบคลุมวิธีใช้ Google Play Console เพื่อตั้งค่า บริการเกมของ Google Play สำหรับเกม Android ของคุณ Google Play Console เป็นศูนย์กลางในการจัดการบริการเกมและกำหนดค่าข้อมูลเมตาสำหรับการอนุญาตและการตรวจสอบสิทธิ์ในเกมของคุณ

หากต้องการเพิ่มเกมไปยัง Google Play Console ให้ทำตามขั้นตอนทั่วไปต่อไปนี้

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

ขั้นตอนเหล่านี้มีรายละเอียดเพิ่มเติมในหัวข้อด้านล่าง

ขั้นตอนที่ 1 ลงชื่อเข้าใช้ Google Play Console

ไปที่ Google Play Console เพื่อลงชื่อเข้าใช้ หากคุณยังไม่เคยลงทะเบียน Google Play Console มาก่อน คุณจะได้รับข้อความแจ้งให้ดำเนินการ

ขั้นตอนที่ 2 เพิ่มเกมลงใน Google Play Console

หากต้องการเพิ่มเกม ให้ทำตามขั้นตอนต่อไปนี้

  1. สร้างเกมใน Play Console หากยังไม่ได้สร้าง ดูรายละเอียดเพิ่มเติมได้ที่นี่
  2. ไปที่เติบโต > บริการเกมของ Play > การตั้งค่าและการจัดการ > การกำหนดค่า

  3. ระบุโปรเจ็กต์บริการเกมของ Play ที่คุณต้องการใช้ สร้างโปรเจ็กต์ใหม่ตั้งแต่ต้นหรือเลือกใช้โปรเจ็กต์ที่มีอยู่

    • สร้างโปรเจ็กต์บริการเกมของ Play ใหม่: คุณต้องใช้โปรเจ็กต์ระบบคลาวด์จึงจะสร้างโปรเจ็กต์บริการ Play Games ได้

      • หากคุณได้สร้างโปรเจ็กต์ระบบคลาวด์สำหรับเกมนี้แล้ว ให้เลือกโปรเจ็กต์ระบบคลาวด์จากรายการแบบเลื่อนลงและเลือกใช้

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

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

  4. ระบบจะสร้างโปรเจ็กต์เกมบริการเกมของ Play และระบบจะสร้างรายการที่เกี่ยวข้องให้คุณใน Google Cloud Console

  5. ในส่วนคุณสมบัติ คุณสามารถเลือกแก้ไขคุณสมบัติ และเพิ่มคำอธิบาย หมวดหมู่ และเนื้อหากราฟิกสำหรับเกมของคุณ

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

ขั้นตอนที่ 3 สร้างรหัสไคลเอ็นต์ OAuth 2.0

เกมของคุณต้องมีรหัสไคลเอ็นต์ OAuth 2.0 จึงจะผ่านการตรวจสอบสิทธิ์และได้รับอนุญาตให้เรียกใช้บริการเกมของ Google Play ใช้ Google Cloud Platform เพื่อสร้างรหัสไคลเอ็นต์เพื่อตั้งค่าข้อมูลเข้าสู่ระบบสำหรับบริการ Play Games ซึ่งเป็นการเชื่อมโยงระหว่างรหัสไคลเอ็นต์กับเกม จากนั้นใช้ Google Play Console เพื่อเพิ่มข้อมูลเข้าสู่ระบบ โดยลิงก์รหัสไคลเอ็นต์กับเกมของคุณ

ดูวิธีการโดยละเอียดเพิ่มเติมได้จากขั้นตอนต่อไปนี้

หากยังไม่ได้กำหนดค่าหน้าจอคำยินยอม OAuth ส่วนข้อมูลเข้าสู่ระบบจะแสดงข้อความเตือนให้คุณกำหนดค่า

ข้อความแจ้งให้กำหนดค่าหน้าจอขอความยินยอม OAuth

คลิก Configure ซึ่งจะเปิดกล่องโต้ตอบที่มีคำแนะนำเพิ่มเติมและลิงก์ในรายละเอียดไปยัง Google Cloud Platform

กำหนดค่าหน้าจอขอความยินยอม OAuth กำหนดค่าและเผยแพร่หน้าการตั้งค่าหน้าจอขอความยินยอม OAuth ใน Google Cloud Platform 1. ไปที่หน้าการตั้งค่าหน้าจอขอความยินยอม OAuth ใน Google Cloud Platform 2. กําหนดให้หน้าจอคํายินยอมพร้อมใช้งานสําหรับทุกคนใน Google Play (ภายนอก) หรือเฉพาะคนในองค์กร (ภายใน) 3. ระบุชื่อแอปพลิเคชัน โดยชื่อนี้ต้องตรงกับชื่อเกมของคุณใน Play Console 4. เพิ่มขอบเขต ได้แก่ Games,games_lite และ drive.appdata 5. เผยแพร่หน้าจอขอความยินยอม 6. กลับไปที่ Play Console เพื่อยืนยันการกำหนดค่า

หากตั้งค่าหน้าจอขอความยินยอม OAuth เสร็จแล้ว ให้คลิกเสร็จสิ้น Google Play Console จะรีเฟรชโดยอัตโนมัติ และหากกำหนดค่าสำเร็จคุณจะสร้างข้อมูลเข้าสู่ระบบได้ ดังนี้

การสร้างข้อมูลเข้าสู่ระบบ

ข. สร้างข้อมูลเข้าสู่ระบบ

หากต้องการให้สิทธิ์เกมของคุณสื่อสารกับบริการเกมของ Google Play คุณต้องสร้างข้อมูลเข้าสู่ระบบที่มีรหัสไคลเอ็นต์ OAuth2 ที่ได้รับอนุญาต

ในส่วนข้อมูลเข้าสู่ระบบ ให้คลิกเพิ่มข้อมูลเข้าสู่ระบบ

ในวิซาร์ด ให้เลือกว่าคุณต้องการสร้างข้อมูลเข้าสู่ระบบ Android (หาก APK ของเกมจะตรวจสอบสิทธิ์ผู้ใช้และใช้ PGS API) หรือข้อมูลเข้าสู่ระบบเซิร์ฟเวอร์เกม (หากเซิร์ฟเวอร์เกมจะใช้ PGS API) ทำตามคำแนะนำ สำหรับประเภทข้อมูลเข้าสู่ระบบที่คุณต้องการโดยเฉพาะ

Android

ตั้งค่ารายละเอียดข้อมูลเข้าสู่ระบบ

ตรวจสอบว่าชื่อในช่องชื่อตรงกับชื่อเกม เลือกว่าจะเปิดใช้ Anti-Piracy หรือไม่

ตั้งค่าการให้สิทธิ์

จากนั้นให้เลือกรหัสไคลเอ็นต์ OAuth ที่จะใช้กับโปรเจ็กต์เกมนี้ หากคุณมีรหัสไคลเอ็นต์ OAuth2 อยู่แล้ว คุณจะเลือกรหัสได้ แต่จะเป็นการสร้างใหม่ คลิกสร้างไคลเอ็นต์ OAuth ซึ่งจะเปิดกล่องโต้ตอบที่มีลิงก์ในรายละเอียดและคำแนะนำสำหรับการสร้างรหัสไคลเอ็นต์ OAuth ใน Google Cloud Platform

  1. เลือกประเภทแอปพลิเคชันเป็น Android
  2. ป้อนชื่อเกมในช่องชื่อ
  3. ป้อนชื่อแพ็กเกจของแอปพลิเคชัน Android ในช่องชื่อแพ็กเกจ

  4. เปิดเทอร์มินัลและเรียกใช้ยูทิลิตี Keytool เพื่อรับลายนิ้วมือ SHA1 ของรุ่นและใบรับรองการแก้ไขข้อบกพร่อง

    หากต้องการรับลายนิ้วมือของใบรับรองรุ่น ให้เรียกใช้คำสั่งต่อไปนี้

    keytool -list -keystore <path-to-production-keystore> -v

    หากต้องการลายนิ้วมือของใบรับรองการแก้ไขข้อบกพร่อง ให้เรียกใช้คำสั่งต่อไปนี้

    keytool -list -keystore <path-to-debug-keystore> -v

  5. ยูทิลิตีเครื่องมือปุ่มจะแจ้งให้คุณป้อนรหัสผ่านสำหรับคีย์สโตร์ รหัสผ่านเริ่มต้นสำหรับคีย์สโตร์สำหรับการแก้ไขข้อบกพร่องคือ android จากนั้นเครื่องมือแป้นจะพิมพ์ ลายนิ้วมือไปยังเทอร์มินัล

  6. วางลายนิ้วมือ SHA1 ลงในช่อง ลายนิ้วมือของใบรับรองการลงชื่อ (SHA1)

  7. คลิกสร้าง

ดูข้อมูลเพิ่มเติมเกี่ยวกับ OAuth 2.0 ใน Android ได้ที่การตรวจสอบสิทธิ์กับบริการ OAuth2

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

คุณอาจต้องสร้างข้อมูลเข้าสู่ระบบ 2 รายการ รายการแรกมีลายนิ้วมือสำหรับใบรับรองรุ่น และอีกรายการมีลายนิ้วมือสำหรับใบรับรองการแก้ไขข้อบกพร่อง อย่าลืมใช้ชื่อแพ็กเกจเดียวกันสำหรับทั้งคู่ วิธีนี้จะช่วยให้บริการเกมของ Google Play จดจำการเรียกจาก APK ที่ลิงก์ซึ่งลงนามด้วยใบรับรองใดใบรับรองหนึ่งได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการลงชื่อใบรับรองสำหรับ Android ได้ที่ลงนามแอป

เซิร์ฟเวอร์เกม

ตั้งค่ารายละเอียดข้อมูลเข้าสู่ระบบ

ตรวจสอบว่าชื่อในช่องชื่อตรงกับชื่อเกม

ตั้งค่าการให้สิทธิ์

จากนั้นให้เลือกรหัสไคลเอ็นต์ OAuth ที่จะใช้กับโปรเจ็กต์เกมนี้ หากคุณมีรหัสไคลเอ็นต์ OAuth2 อยู่แล้ว คุณจะเลือกรหัสได้ แต่จะเป็นการสร้างใหม่ คลิกสร้างไคลเอ็นต์ OAuth ซึ่งจะเปิดกล่องโต้ตอบที่มีลิงก์ในรายละเอียดและคำแนะนำสำหรับการสร้างรหัสไคลเอ็นต์ OAuth ใน Google Cloud Platform

  1. เลือกเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน
  2. ป้อนชื่อเกมในช่องชื่อ
  3. คลิกสร้าง

ดูข้อมูลเพิ่มเติมเกี่ยวกับ OAuth 2.0 ใน Android ได้ที่การตรวจสอบสิทธิ์กับบริการ OAuth2

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

การหลีกเลี่ยงปัญหาการตั้งค่าที่พบบ่อย

เพื่อหลีกเลี่ยงความผิดพลาดในการตั้งค่าที่พบบ่อย โปรดปฏิบัติตามคำแนะนำเหล่านี้เมื่อตั้งค่าเกมให้ใช้บริการเกมของ Google Play

1. ตั้งค่าเกมด้วย Google Play Console
หากคุณสร้างรหัสไคลเอ็นต์ OAuth 2.0 สำหรับแอปใน Google Cloud Console บริการเกมของ Google Play จะไม่ทราบถึงความเชื่อมโยงระหว่างรางวัลพิเศษของเกมกับลีดเดอร์บอร์ด รวมถึงรหัสไคลเอ็นต์ หากต้องการสร้างการเชื่อมโยงนี้ คุณต้องสร้างข้อมูลเข้าสู่ระบบโดยใช้รหัสไคลเอ็นต์ OAuth 2.0 ตามที่อธิบายไว้ในสร้างข้อมูลเข้าสู่ระบบ
2. ใช้รหัสแอปพลิเคชันที่ถูกต้องใน Android
รหัสแอปพลิเคชันเป็นทรัพยากรสตริงที่จำเป็นซึ่งคุณต้องอ้างอิงในไฟล์ Manifest ของ Android สตริงรหัสแอปพลิเคชันมีเพียงตัวเลข (โดยทั่วไปคือ 12 หลักขึ้นไป) ที่ตอนต้นของรหัสไคลเอ็นต์ที่ Google Play Console ให้ไว้ ดูรหัสแอปพลิเคชันได้ที่ด้านบนของหน้าการกำหนดค่า และมีป้ายกำกับว่ารหัสโปรเจ็กต์ใต้ชื่อเกม
3. รับรอง APK ด้วยใบรับรองที่ถูกต้อง
เมื่อลิงก์แอป Android กับเกมใน Google Play Console คุณต้องใช้ชื่อแพ็กเกจและลายนิ้วมือใบรับรองเดียวกันกับที่ใช้เผยแพร่แอป หากข้อมูลไม่ตรงกัน การเรียกใช้บริการเกมของ Google Play จะล้มเหลว คุณควรสร้างรหัสไคลเอ็นต์ 2 รหัส โดยรหัสแรกจะมีลายนิ้วมือของใบรับรองรุ่น และอีกรหัสหนึ่งมีลายนิ้วมือของใบรับรองการแก้ไขข้อบกพร่อง และใช้ชื่อแพ็กเกจเดียวกันสำหรับทั้งสองรหัส ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีระบุใบรับรองที่มีการรับรองใน Google Play Console ได้ที่การลงชื่อเข้าใช้แอปพลิเคชันของคุณ
4. เมื่อพัฒนาสำหรับ Android ให้รวม Play Games SDK เป็นโปรเจ็กต์ไลบรารี ไม่ใช่ JAR แบบสแตนด์อโลน
ตรวจสอบว่ามีการอ้างอิง SDK บริการ Google Play เป็นโปรเจ็กต์ไลบรารีในโปรเจ็กต์ Android มิฉะนั้นแล้วอาจทำให้เกิดข้อผิดพลาดเมื่อแอปไม่พบทรัพยากรของบริการ Google Play ดูวิธีตั้งค่าโปรเจ็กต์ Android เพื่อใช้บริการ Google Play ได้ที่การตั้งค่าบริการ Google Play
5. ลงชื่อเข้าใช้ด้วยบัญชีผู้ทดสอบในระหว่างการพัฒนา
หากยังไม่ได้เผยแพร่การเปลี่ยนแปลงการตั้งค่าเกมใน Google Play Console คุณอาจพบข้อผิดพลาดระหว่างการทดสอบหากไม่ได้ลงชื่อเข้าใช้ด้วยบัญชีผู้ทดสอบที่ได้รับอนุญาตพิเศษ คุณควรเปิดใช้บัญชีผู้เผยแพร่ของ Google Play Console สำหรับการทดสอบเสมอ ดูวิธีจัดการบัญชีผู้ทดสอบได้ที่การเปิดใช้บัญชีสำหรับการทดสอบ
6. เผยแพร่หน้าจอขอความยินยอมใน Google Cloud Platform
ก่อนเผยแพร่แอปใน Google Play Console ให้เผยแพร่หน้าจอขอความยินยอมใน Google Cloud Platform หากไม่ทำขั้นตอนนี้ ผู้ชมสาธารณะจะใช้ฟีเจอร์ของบริการเกมของ Play ไม่ได้
7. เมื่อเผยแพร่ ให้เผยแพร่การตั้งค่าบริการเกมของ Play ก่อนจะเผยแพร่เกม
นักพัฒนาแอปอาจเผยแพร่แอปของตนโดยไม่ได้ตั้งใจโดยไม่เผยแพร่ การตั้งค่าบริการเกมของ Google Play ที่สอดคล้องกันสำหรับแอปของตน ซึ่งอาจทำให้ผู้เล่นที่ลงชื่อเข้าใช้ด้วยบัญชีที่ไม่ใช่ผู้ทดสอบ พบข้อผิดพลาด เนื่องจากแอปอ้างอิงการตั้งค่าเกมที่ถูกต้องไม่ได้ เมื่อเปิดตัวเกม อย่าลืมเผยแพร่การตั้งค่าเกมก่อนโดยใช้ตัวเลือกเผยแพร่เกมใน Google Play Console หากต้องการเรียนรู้วิธีเผยแพร่การเปลี่ยนแปลง โปรดดูการเผยแพร่การเปลี่ยนแปลงเกม

ดูเคล็ดลับเพิ่มเติมได้ที่หัวข้อต่อไปนี้

ขั้นตอนถัดไป

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

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