เนื่องจากขั้นตอนการลงชื่อเข้าใช้เป็นการโต้ตอบแรกที่ผู้ใช้อาจมีกับส่วนเสริมของคุณ จึงต้องทำให้ผู้ใช้ดำเนินการตามขั้นตอนต่างๆ ได้อย่างราบรื่นมากที่สุด อ่านส่วนต่างๆ ด้านล่างเพื่อทำความคุ้นเคยกับ API การลงชื่อเข้าใช้ต่างๆ, พารามิเตอร์การค้นหาที่เกี่ยวข้องกับการลงชื่อเข้าใช้, วิธีจัดการตัวบล็อกป๊อปอัป และแผนการทดสอบที่คุณใช้ระหว่างการพัฒนาได้เพื่อให้แน่ใจว่าคุณทำตามแนวทางปฏิบัติแนะนำแล้ว
รายละเอียดการใช้งาน SSO
OAuth 2.0 ของ Google เข้ากันได้กับสแต็ก OAuth 2.0 จำนวนมาก เราขอแนะนำอย่างยิ่งให้ใช้การให้สิทธิ์ฝั่งเซิร์ฟเวอร์เนื่องจากเป็นตัวเลือกด้านความปลอดภัยที่สูงที่สุดและรองรับการใช้พารามิเตอร์การค้นหาของ iframe
ดูคําแนะนําทางเทคนิคที่ระบุไว้ในเว็บไซต์ Google Identity เมื่อใช้ Google Sign-In โปรดทำตามหลักเกณฑ์การใช้แบรนด์สำหรับการลงชื่อเข้าใช้ของ Google ไฟล์ Sketch, SVG และ EPS มีพร้อมให้ดาวน์โหลด
การทดสอบการลงชื่อเข้าใช้
ใช้แผนการทดสอบของส่วนเสริมเพื่อตรวจสอบว่าส่วนเสริมเป็นไปตามมาตรฐานที่กำหนดและสามารถจัดการ Edge Case ที่ทราบได้ก่อนส่งส่วนเสริมเข้ารับการตรวจสอบ การทดสอบเหล่านี้คล้ายกับรายการตรวจสอบข้อกำหนดของส่วนเสริมของ Classroom อย่างใกล้ชิด และจะแสดงวิธีการแบบทีละขั้นตอนในการตรวจสอบว่าส่วนเสริมตรงตามข้อกำหนดเหล่านั้นหรือไม่ ซึ่งเป็นการทดสอบเดียวกับที่แอปพลิเคชันได้รับการทดสอบระหว่างการเผยแพร่
พารามิเตอร์การค้นหาการลงชื่อเข้าใช้
Google Classroom มีพารามิเตอร์การค้นหา login_hint เพื่อช่วยอำนวยความสะดวกในการลงชื่อเข้าใช้ซ้ำ ดูข้อมูลเพิ่มเติมได้ที่ส่วนพารามิเตอร์ที่เกี่ยวข้องกับการลงชื่อเข้าใช้ของหน้าพารามิเตอร์การค้นหาของ iframe ดูโค้ดตัวอย่างได้ในคำแนะนำแบบทีละขั้นเกี่ยวกับการจัดการการเข้าชมซ้ำในคำแนะนำแบบทีละขั้นสำหรับนักพัฒนาซอฟต์แวร์ของเรา
จัดการตัวบล็อกป๊อปอัป
หน้าต่างกล่องโต้ตอบการลงชื่อเข้าใช้ช่วยอำนวยความสะดวกในการลงชื่อเข้าใช้ส่วนเสริม หน้าต่างนี้จะแสดงหน้าจอตัวเลือกบัญชีและอนุญาตให้ผู้ใช้ให้สิทธิ์ OAuth ตัวบล็อกป๊อปอัปของผู้ใช้ปลายทางอาจทำให้ขั้นตอนการลงชื่อเข้าใช้ไม่เสร็จสมบูรณ์
รูปที่ 1 ตัวอย่างหน้าจอตัวเลือกบัญชี
ในการแก้ปัญหานี้ ให้ผู้ใช้ปลายทางมีปุ่มสำหรับคลิกเพื่อข้ามตัวบล็อกป๊อปอัป ซึ่งการโต้ตอบนี้จะทำให้ระบบแสดงกล่องโต้ตอบการลงชื่อเข้าใช้ เพื่อให้ผู้ใช้ปลายทางลงชื่อเข้าใช้ต่อไปได้ ตรวจสอบว่าปุ่มที่คุณระบุเป็นไปตามหลักเกณฑ์การใช้แบรนด์สำหรับการลงชื่อเข้าใช้
ทำตามคำแนะนำในการลงชื่อเข้าใช้ในคำแนะนำแบบทีละขั้นสำหรับนักพัฒนาซอฟต์แวร์ของเรา เพื่อใช้งานปุ่มลงชื่อเข้าใช้ที่มีแบรนด์ Google ที่สามารถคลิกได้เพื่อเรียกใช้กล่องโต้ตอบการลงชื่อเข้าใช้
การเข้าสู่ระบบหลายบัญชี
เบราว์เซอร์ที่มีการลงชื่อเข้าใช้หลายบัญชีพร้อมกันอาจขัดขวางกระบวนการของผู้ใช้ส่วนเสริม ผู้ใช้ปลายทางอาจออกจากระบบบัญชี Google ทั้งหมดในเบราว์เซอร์ปัจจุบันหรือเปิด Classroom ในหน้าต่าง Chrome ที่ไม่ระบุตัวตนก่อนลงชื่อเข้าใช้ด้วยบัญชีที่ถูกต้องและลองดำเนินการอีกครั้ง
หากผู้ใช้ที่ไม่ถูกต้องลงชื่อเข้าใช้ส่วนเสริมเนื่องจากปัญหาการเข้าสู่ระบบหลายบัญชี การเรียกไปยัง API ของส่วนเสริมของ Classroom อาจล้มเหลวโดยมีข้อผิดพลาด InvalidAddOnToken หากคุณได้รับข้อผิดพลาดดังกล่าว คุณควรแจ้งให้ผู้ใช้ออกจากระบบบัญชีอื่นๆ ทั้งหมดในเบราว์เซอร์หรือเปิด Classroom ในหน้าต่าง Chrome ที่ไม่ระบุตัวตนแทน