เปรียบเทียบส่วนเสริมของ Classroom กับเครื่องมือ LTI

Learning Tools Interoperability (LTI) เป็นเฟรมเวิร์กแบบเปิดสำหรับการสร้าง การผสานรวมของบุคคลที่สามในระบบบริหารจัดการการเรียนรู้ แม้ว่าส่วนเสริมของ Classroom และเครื่องมือ LTI จะรองรับเส้นทางของผู้ใช้ที่คล้ายกัน แต่เฟรมเวิร์กทั้ง 2 แบบก็ไม่สามารถใช้งานร่วมกันได้โดยตรง คู่มือนี้ จะเปรียบเทียบการผสานรวมทั้ง 2 ประเภทและไฮไลต์ความแตกต่างที่สําคัญ นอกจากนี้ ยัง แนะนำวิธีสร้างเส้นทางของผู้ใช้ที่คล้ายกันเมื่อปรับเครื่องมือ LTI ให้ทำงาน เป็นส่วนเสริมของ Classroom

การโต้ตอบระหว่างแพลตฟอร์มและเครื่องมือ

ความแตกต่างที่สำคัญระหว่างเครื่องมือ LTI กับส่วนเสริมของ Classroom คือ วิธีการแลกเปลี่ยนข้อมูล โดยปกติแล้วเครื่องมือ LTI จะใช้ HTTP POST เพื่อ ส่งเพย์โหลดไปยังแพลตฟอร์ม LTI ขณะที่ส่วนเสริมของ Classroom จะสร้างและดึงข้อมูลทรัพยากรโดยใช้ Google Classroom REST API

ตารางต่อไปนี้สรุปวิธีทำให้เครื่องมือ LTI ทำงานที่สำคัญได้ด้วย Google Classroom

ฟีเจอร์	LTI	Classroom
สร้างงาน	บริการ Assignments และบริการคะแนน	สร้างทรัพยากร CourseWork และ AddOnAttachment
โพสต์คะแนน	บริการ Assignments และบริการคะแนน	แก้ไขCourseWorkและAddOnAttachmentงานที่นักเรียนส่ง
เปิดตัวเส้นทาง	การทำ Deep Link	ระบุ URI ในAddOnAttachment ทรัพยากร
อ่านบัญชีรายชื่อหลักสูตร	บริการจัดสรรชื่อและบทบาท	เรียกดูโปรไฟล์ Student และ Teacher ในหลักสูตร

ปรับเครื่องมือ LTI ให้เป็นส่วนเสริมของ Classroom

การโต้ตอบ LTI หลายอย่างมีลักษณะคล้ายกันในเฟรมเวิร์กส่วนเสริมของ Classroom ส่วนต่อไปนี้จะอธิบายแนวคิดหลักบางอย่างและหลักสูตรการดำเนินการที่แนะนำ

กำหนดค่าแอปพลิเคชัน

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

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

คำแนะนำ: ทำตามคำแนะนำในการสร้างและกำหนดค่า โปรเจ็กต์ Google Cloud สำหรับส่วนเสริมของ Classroom ที่สำคัญที่สุดคือระบุ URL สำหรับการเปิดตัวส่วนเสริมเป็น URI การค้นพบไฟล์แนบใน Marketplace SDK URL นี้อาจเหมือนกับเส้นทางการเปิดใช้เครื่องมือ LTI ที่มีอยู่ตราบใดที่เส้นทางนั้นเปลี่ยนเส้นทางผู้ใช้ไปยังขั้นตอนการตรวจสอบสิทธิ์ที่เหมาะสม

ขั้นตอนการตรวจสอบสิทธิ์

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

ในทางตรงกันข้าม โฟลว์ OAuth ของ Google เป็นโฟลว์แบบ 3 ทาง ซึ่งเกี่ยวข้องกับผู้ใช้ปลายทาง แอปพลิเคชันไคลเอ็นต์ภายนอก และเซิร์ฟเวอร์การตรวจสอบสิทธิ์ ไคลเอ็นต์จะได้รับโทเค็นพร้อมความยินยอมของผู้ใช้อย่างชัดแจ้ง ซึ่งให้สิทธิ์เข้าถึงทรัพยากร Google Classroom ของผู้ใช้

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

คำแนะนำ: เมื่อ URL ที่เชื่อมโยงกับเครื่องมือหรือ ส่วนเสริมได้รับคำขอขาเข้า ให้ตรวจสอบคำขอเพื่อดูว่ามีพารามิเตอร์การค้นหาของส่วนเสริม Classroom หรือไม่ หากมี ให้ใช้ Google Identity SDK เพื่อรับข้อมูลเข้าสู่ระบบสำหรับการเข้าถึงสำหรับผู้ใช้ จัดเก็บข้อมูลเข้าสู่ระบบในเซสชันของผู้ใช้และใช้ข้อมูลดังกล่าวเพื่อส่งคำขอ Classroom API ในภายหลัง หากไม่มีพารามิเตอร์การค้นหา ให้ใช้คำขอ HTTP เพื่อโต้ตอบกับปลายทาง LTI ของแพลตฟอร์ม

การสร้างเนื้อหาส่วนเสริมใน Google Classroom

ส่วนเสริมของ Classroom รองรับเนื้อหาประเภทเดียวคือลิงก์ URL ไปยังหน้าที่โฮสต์ภายนอก ลิงก์เหล่านี้อยู่ในแหล่งข้อมูล AddOnAttachment ซึ่งกำหนดเส้นทางเว็บที่จะเปิดเมื่อผู้ใช้โต้ตอบกับ ส่วนเสริม URL แต่ละรายการจะเปิดขึ้นในสถานการณ์ที่เฉพาะเจาะจง โปรดดูรายละเอียดทั้งหมดในคำแนะนำเกี่ยวกับ iframe URL เหล่านี้เทียบเท่ากับลิงก์ทรัพยากร LTI

ส่วนเสริมของ Classroom ไม่รองรับเนื้อหาประเภทอื่นๆ เช่น ไฟล์ รูปภาพ หรือส่วน HTML

คำแนะนำ: เมื่อผู้ใช้เลือกเนื้อหาในผลิตภัณฑ์ของคุณ ให้ขอข้อมูลเข้าสู่ระบบ OAuth ของผู้ใช้และส่งคำขอ AddOnAttachments.create คำขอ ควรมีออบเจ็กต์ AddOnAttachment ที่มี URL สำหรับมุมมองของนักเรียน มุมมองของครู และ (ไม่บังคับ) มุมมองการให้คะแนน โปรดทราบว่ามีปลายทาง API แยกต่างหากสำหรับการสร้างไฟล์แนบในประกาศ งานหรือสื่อการเรียนการสอน เฉพาะไฟล์แนบที่สร้างในงานเท่านั้นที่จะมีมุมมองการให้คะแนน เนื่องจากเป็นรายการในสตรีมของ Classroom เพียงประเภทเดียวที่ยอมรับงานที่นักเรียนส่ง

การเปรียบเทียบฟีเจอร์ของเฟรมเวิร์ก

ตำแหน่งการผสานรวม

ส่วนเสริมของ Classroom จะสร้างไฟล์แนบในประกาศ งาน และสื่อการเรียนการสอนของหลักสูตร รายการเหล่านี้คือรายการที่ปรากฏในแท็บ สตรีมของหลักสูตรใน UI ของ Classroom

ครูเริ่มเส้นทางการสร้างไฟล์แนบส่วนเสริมได้โดยเลือกส่วนเสริมในตัวเลือกในขั้นตอนการสร้างงาน ดูรายละเอียด การอภิปรายเกี่ยวกับมุมมองแต่ละรายการที่แสดงต่อผู้ใช้ได้ในคำแนะนำเกี่ยวกับ iframe

หรือนักพัฒนาแอปจะสร้างงานแบบเป็นโปรแกรมด้วยไฟล์แนบของส่วนเสริมก็ได้ ดูรายละเอียดได้ในคำแนะนำเกี่ยวกับการสร้างไฟล์แนบนอก Google Classroom

ข้อมูลบริบทการเปิดตัว

Classroom จะเพิ่มพารามิเตอร์การค้นหาหลายรายการลงในแต่ละ URL เมื่อ เปิดเส้นทางของส่วนเสริม ซึ่งรวมถึงประเภทรายการสตรีมและตัวระบุสำหรับหลักสูตรและรายการสตรีมเสมอ ข้อมูลอื่นๆ อาจปรากฏขึ้น ขึ้นอยู่กับมุมมองของ iframe เช่น ตัวระบุไฟล์แนบหรือตัวอย่างข้อมูลที่ส่ง โทเค็นเพื่อให้สิทธิ์ในการสร้างไฟล์แนบ หรือ URL เพื่ออัปเกรดจากลิงก์เป็นไฟล์แนบของส่วนเสริม

Classroom จะไม่ส่งข้อมูลใดๆ เกี่ยวกับผู้ใช้หรือ สถาบันโดยค่าเริ่มต้น คุณดูข้อมูลเกี่ยวกับผู้ใช้ได้จากแหล่งข้อมูล UserProfile ของ Classroom API ซึ่งรวมถึงรหัสผู้ใช้ หากผู้ใช้เป็นผู้ดูแลระบบโดเมน คุณจะดูข้อมูลเกี่ยวกับสถาบันได้จาก Workspace Admin SDK

การตรวจสอบสิทธิ์และการให้สิทธิ์

ส่วนเสริมของ Classroom ต้องใช้ลงชื่อเข้าใช้ด้วย Google เพื่อการตรวจสอบสิทธิ์ผู้ใช้ เมื่อลงชื่อเข้าใช้แล้ว ผู้ใช้จะให้สิทธิ์แก่แอปพลิเคชันของคุณ ผ่านขอบเขต OAuth 2.0 แอปพลิเคชันของคุณสามารถใช้ขอบเขต OAuth ที่ใช้ได้ร่วมกันได้ทุกแบบ

การค้นพบและการกำหนดค่าแอป

ผู้ใช้จะค้นหาและ "ติดตั้ง" ส่วนเสริมของ Classroom ผ่าน Google Workspace Marketplace การติดตั้งในคลิกเดียวจะทำให้แอปพลิเคชันส่วนเสริมพร้อมใช้งานสำหรับครูแต่ละคน นอกจากนี้ ผู้ดูแลระบบยังติดตั้งแอปพลิเคชันส่วนเสริม สำหรับครูทุกคนในหน่วยขององค์กรหรือโดเมนได้ด้วย จากนั้นนักเรียนทุกคนในหลักสูตรจะเข้าถึงไฟล์แนบ ที่สร้างด้วยแอปพลิเคชันได้ ผู้ใช้ปลายทางไม่จำเป็นต้องจัดการโทเค็น คีย์ หรือตัวระบุสำหรับส่วนเสริมของ Classroom แต่ละรายการ

UX และขั้นตอนของผลิตภัณฑ์

ในหลายกรณี เวิร์กโฟลว์ผลิตภัณฑ์ที่มีอยู่ของเครื่องมือ LTI จะทำงานได้ดีในฐานะ ส่วนเสริมของ Classroom ส่วนเสริมของ Classroom จะช่วยให้คุณสร้างและจัดการลิงก์ไปยังเนื้อหาบนแพลตฟอร์มของเราได้เช่นเดียวกับเครื่องมือ LTI ไฟล์แนบของส่วนเสริม Classroom จะคล้ายกับลิงก์ Deep Linking ของ LTI หากเครื่องมือ LTI สร้าง URL ที่ชี้ไปยัง เนื้อหาที่โฮสต์ไว้ เครื่องมือดังกล่าวควรทำงานได้ดีในฐานะส่วนเสริมของ Classroom

ให้คะแนนงานของนักเรียน

คุณจะดูและให้คะแนนไฟล์แนบของส่วนเสริม Classroom ได้ใน มุมมองการให้คะแนนของ Classroom เมื่อแนบเนื้อหาที่ต้องให้นักเรียนส่งงาน คุณจะระบุstudent_work_review_uriที่ผู้สอน สามารถดูและให้คะแนนงานของนักเรียนคนใดคนหนึ่งได้ ซึ่งแตกต่างจาก LTI ที่เครื่องมือจะกำหนดเฉพาะ target_link_uri ที่ใช้ร่วมกันระหว่างครูและนักเรียน/นักศึกษา การติดตั้งใช้งานส่วนเสริมของ Classroom มีความคล้ายคลึงกับบริการตรวจสอบการส่งผ่าน LTI ที่กำลังจะเปิดตัวมากที่สุด