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

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

ประเด็นสำคัญ: การผสานรวม CourseWork ช่วยให้นักพัฒนาแอปเข้าถึงและแก้ไขสถานะของประกาศ สื่อการเรียนการสอน งาน และงานที่ส่งของนักเรียนใน Google Classroom โดยใช้โปรแกรมได้ เลือกเส้นทางนี้หากต้องการวิธีส่งเนื้อหาไปยัง Classroom แบบประหยัดค่าใช้จ่าย

เส้นทางการผสานรวมนี้มักใช้สร้างและคะแนนงานที่มีลิงก์ไปยังแหล่งข้อมูลภายนอก 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 มีข้อจำกัดที่สำคัญบางอย่าง หากข้อมูลเหล่านี้ทำให้คุณไม่เข้าใจผลิตภัณฑ์ ให้พิจารณาสร้าง ส่วนเสริม Google Classroom แทน

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

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