การตั้งค่าบริการเกมของ 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. ระบุว่าเกมของคุณใช้ Google API อยู่แล้ว (เช่น Firebase) หรือไม่ การเลือกตัวเลือกที่ถูกต้องเป็นสิ่งสําคัญมาก

   • หากเป็นเกมที่คุณสร้างใหม่ตั้งแต่ต้นหรือไม่เคยตั้งค่า Google API สําหรับเกมนั้นมาก่อน ให้เลือกไม่ เกมของฉันไม่ได้ใช้ Google API ป้อนชื่อเกมแล้วคลิกสร้าง
   • หากเป็นเกมที่คุณตั้งค่า Google API ไว้อย่างน้อย 1 รายการ ให้เลือกใช่ เกมของฉันใช้ Google API อยู่แล้ว คุณจะเห็นรายการโปรเจ็กต์จาก Google Cloud Console ที่คุณอยู่ในรายชื่อนักพัฒนาซอฟต์แวร์ เลือกโปรเจ็กต์จากรายการ แล้วคลิกใช้
   • หากต้องการใช้โปรเจ็กต์บริการเกมของ Play ที่มีอยู่ ให้เลือกใช้โปรเจ็กต์บริการเกมของ Play ที่มีอยู่ คุณจะเห็นรายการโปรเจ็กต์บริการเกมของ Play ที่มีอยู่สําหรับบัญชีของคุณ เลือกโปรเจ็กต์เกมที่ถูกต้องจากรายการ แล้วคลิกใช้ ตัวเลือกนี้ไม่ใช่ตัวเลือกทั่วไป แต่คุณสามารถดําเนินการนี้ได้หากกําลังสร้างเกมใหม่ใน Play Console เพื่อเปลี่ยนชื่อแพ็กเกจ หรือหากคุณมีเกมเวอร์ชันฟรีและแบบชําระเงินที่มีชื่อแพ็กเกจต่างกัน

4. ระบบจะสร้างโปรเจ็กต์เกมบริการเกมของ Play ขึ้นมาและจะมีการสร้างรายการที่สอดคล้องกันในคอนโซล Google Cloud

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

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

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

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

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

ก. กําหนดค่าหน้าจอขอความยินยอม OAuth

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

คลิกกําหนดค่า ซึ่งจะเปิดกล่องโต้ตอบที่มีวิธีการเพิ่มเติมและ Deep Link ไปยัง Google Cloud Platform

หมายเหตุ: ตรวจสอบว่าหน้าจอเกมพร้อมให้บริการสําหรับทุกคน รายการขอบเขตสุดท้ายต้องมี games, games_lite และ drive.appdata ขอบเขตเหล่านี้ไม่ต้องใช้การยืนยันแอป เราขอแนะนําให้เผยแพร่หน้าจอให้ความยินยอมทันที หากทําไม่ได้ คุณสามารถกําหนดให้หน้าจอขอความยินยอมพร้อมใช้งานสําหรับผู้ทดสอบเพื่อให้ลงชื่อเข้าใช้เกมได้

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

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

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

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

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

Android

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

ตรวจสอบว่าชื่อในช่องชื่อตรงกับชื่อเกม เลือกว่าจะเปิดใช้การต่อต้านการละเมิดลิขสิทธิ์หรือไม่

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

ถัดไป ให้เลือกรหัสไคลเอ็นต์ OAuth ที่จะใช้สําหรับโปรเจ็กต์เกมนี้ หากคุณมีรหัสไคลเอ็นต์ OAuth2 อยู่แล้ว คุณจะเลือกได้ แต่มักจะสร้างใหม่ คลิกสร้างไคลเอ็นต์ OAuth ซึ่งจะเปิดกล่องโต้ตอบที่มี Deep Link และวิธีการสร้างรหัสไคลเอ็นต์ 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

   หมายเหตุ: ใน Windows คีย์สโตร์การแก้ไขข้อบกพร่องจะอยู่ที่ C:\Users\<USERNAME>\.android\debug.keystore สําหรับ Mac หรือ Linux โดยปกติคีย์สโตร์การแก้ไขข้อบกพร่องจะอยู่ที่ ~/.android/debug.keystore

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

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

7. คลิกสร้าง

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

คําเตือน: ตรวจสอบว่าได้บันทึกชื่อแพ็กเกจและใบรับรองที่มีการรับรองไว้ในขั้นตอนนี้แล้ว การใช้ใบรับรองหรือชื่อแพ็กเกจอื่นในแอปพลิเคชันจะทําให้การตรวจสอบสิทธิ์ไม่สําเร็จ

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

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

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

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

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

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

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

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

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

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

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

เพื่อหลีกเลี่ยงข้อผิดพลาดที่พบบ่อยในการตั้งค่า โปรดตรวจสอบว่าได้ทําตามคําแนะนําเหล่านี้เมื่อตั้งค่าเกมเพื่อใช้บริการเกมของ 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 รหัส โดยรหัสหนึ่งมีลายนิ้วมือของใบรับรองการเผยแพร่ และอีกรหัสมีลายนิ้วมือสําหรับใบรับรองการแก้ไขข้อบกพร่อง และใช้ชื่อแพ็กเกจเดียวกันสําหรับทั้ง 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 ดูวิธีเผยแพร่การเปลี่ยนแปลงได้ที่การเผยแพร่การเปลี่ยนแปลงเกม

ดูเคล็ดลับเพิ่มเติมได้ที่

• คู่มือการแก้ปัญหา Android - เอกสารสําหรับนักพัฒนาซอฟต์แวร์ซึ่งอธิบายวิธีการแก้ปัญหาขณะพัฒนาเกม Android

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

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

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