การผสานรวมกับ CourseWork

นักพัฒนาแอปสามารถใช้ Google Classroom API เพื่อโต้ตอบกับงานใน Google Classroom ได้ แอปพลิเคชันที่ใช้ API ในลักษณะนี้เรียกว่าCourseWorkการผสานรวม

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

วิธีการทำงาน

ฟีเจอร์หลักของCourseWorkการผสานรวมคือการสร้างและการจัดการ งาน ประกาศ และสื่อการเรียนการสอนโดยใช้ Classroom API

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

1. ผู้ใช้ที่เป็นครูลงชื่อเข้าใช้เว็บไซต์ของคุณ
2. ครูค้นหาหรือสร้างเนื้อหาที่ต้องการแชร์กับชั้นเรียน ครูจะคลิกปุ่มในเว็บไซต์ของคุณเพื่อส่งเนื้อหานี้ไปยัง Google Classroom
3. แอปพลิเคชันของคุณส่งคำขอไปยัง courses.courseWork.create คำขอมีออบเจ็กต์ CourseWork ในเนื้อหาซึ่งมีข้อมูลต่อไปนี้
   • รหัสหลักสูตรปลายทาง
   • ชื่อของงาน
   • ข้อความคำอธิบายของงาน
   • link Material ที่มี URL ไปยังเนื้อหาที่ครูเลือก
   • คะแนนสูงสุดที่ทำได้สำหรับเนื้อหาที่เลือก (ไม่บังคับ)
4. งานใหม่จะปรากฏใน Classroom พร้อมไฟล์แนบที่เป็นลิงก์ ลิงก์จะอ้างอิงถึง URL ที่ระบุไว้ในคำขอ create ดูตัวอย่างได้ที่รูปที่ 1
5. นอกจากนี้ คอลัมน์ใหม่สำหรับงานจะปรากฏในสมุดพก คะแนนของ Classroom ด้วย ซึ่งรวมถึงคะแนนสูงสุดหากมีการระบุ
6. นักเรียนจะได้รับงานและคลิก link Material เพื่อเปิด URL ที่ระบุในแท็บใหม่ แล้วดูหรือทำเนื้อหาในเว็บไซต์ของคุณให้เสร็จ คุณอาจให้ตัวควบคุมแก่นักเรียนเพื่อส่งงานได้
7. ไม่บังคับ) ส่งคำขอไปยัง courses.courseWork.studentSubmissions.modifyAttachments เพื่อเพิ่ม ไฟล์แนบในการส่งของนักเรียน เช่น ไฟล์ใน Google ไดรฟ์หรือ link Material ที่ชี้ไปยังงานของนักเรียนในเว็บไซต์ของคุณ
8. คุณจะส่งคำขอไปยัง courses.courseWork.studentSubmissions.patch เพื่อตั้งคะแนนของนักเรียน สำหรับงานที่มอบหมายก็ได้

รูปที่ 1 มุมมองของครูเมื่อแก้ไขงานที่link Material สร้างขึ้นจากการผสานรวมกับ CourseWork

หรือจะโทรหา courses.announcements.create หรือ courses.courseWorkMaterials.create เพื่อสร้างประกาศหรือสื่อการเรียนการสอน แทนงานก็ได้ ดูคำอธิบายโดยละเอียดของการดำเนินการที่เกี่ยวข้องใน Classroom API ได้ที่หน้าสร้างและจัดการงานในชั้นเรียนและตั้งค่าและอัปเดตคะแนน

ข้อควรพิจารณา

โปรดคำนึงถึงสิ่งต่อไปนี้ก่อนตัดสินใจว่าการผสานรวม CourseWork เป็น ตัวเลือกที่เหมาะสมกับความต้องการของผลิตภัณฑ์หรือไม่

• คุณต้องให้สิทธิ์ผู้ใช้และขอความยินยอมจากผู้ใช้ คุณกำลังส่งคำขอ API ในนามของผู้ใช้ ซึ่งหมายความว่าคุณจะสร้างงานในหลักสูตร Google Classroom ใดก็ได้ไม่ได้ แต่จะสร้างงานได้เฉพาะในหลักสูตรที่ผู้ใช้ที่ได้รับอนุญาตสอนเท่านั้น
• คุณต้องมีวิธีให้ผู้ใช้เลือกหลักสูตรเพื่อรับเนื้อหา ลองใช้ courses.list เพื่อดูรายชื่อหลักสูตรที่ผู้ใช้สอน แล้วอนุญาตให้ผู้ใช้เลือกหลักสูตรอย่างน้อย 1 หลักสูตรจากรายการ
• เมื่อผู้ใช้คลิก link Material ใน Classroom ลิงก์จะเปิดขึ้นในแท็บใหม่ เซิร์ฟเวอร์จะไม่ได้รับข้อมูลใดๆ จาก Classroom เมื่อ URL เปิดขึ้น
• ครูสามารถแก้ไขหรือลบงานในชั้นเรียนได้โดยไม่ขึ้นอยู่กับ นักพัฒนาแอป ซึ่งหมายความว่าความรู้ของนักพัฒนาซอฟต์แวร์เกี่ยวกับหลักสูตรอาจ ล้าสมัย หากต้องการทราบการเปลี่ยนแปลงในงานของชั้นเรียน ให้พิจารณาตั้งค่าข้อความ Push สำหรับการเปลี่ยนแปลงงานของชั้นเรียน
• ครูสามารถสร้างหลักสูตรใน UI ของ Classroom โดย วางลิงก์ไปยัง URL ในเว็บไซต์ของคุณ งานในชั้นเรียนที่สร้างด้วยวิธีนี้จะเป็นของครูเท่านั้น คุณจึงดู แก้ไข หรือตั้งค่าคะแนนการส่งโดยใช้ Classroom API ไม่ได้