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