บทนำ

งานใน Classroom เรียกว่ารายการ CourseWork ซึ่งจะอยู่ใน หน้างานของชั้นเรียนในหลักสูตร Classroom ที่กำหนด แม้ว่าจะมีรายการใน Classwork อยู่ 4 ประเภท แต่คู่มือนี้จะเน้นเฉพาะประเภท "งาน" หากต้องการดูวิธีจัดการงานของชั้นเรียนประเภทอื่นๆ โปรดอ่านคู่มือการจัดการงานของชั้นเรียน

Google Classroom มี 2 วิธีในการผสานรวมกับเวิร์กโฟลว์ของงาน ได้แก่ ปุ่มแชร์กับ Classroom และ Classroom API ปุ่มแชร์ช่วยให้ผู้ใช้แชร์เนื้อหาเป็นรายการสตรีมใดก็ได้ผ่านกล่องโต้ตอบป๊อปอัปของ Classroom ในขณะที่ Classroom API ช่วยให้เวิร์กโฟลว์ของงานตั้งแต่ต้นจนจบ ซึ่งรวมถึงการสร้างงาน การสร้างและการจัดการ งานที่นักเรียน/นักศึกษาส่ง และการส่งคะแนนคืน

ในส่วนนี้ เราจะดูความแตกต่างที่สำคัญระหว่างข้อเสนอสำหรับนักพัฒนาแอปทั้ง 2 รายการนี้ กล่าวโดยละเอียดคือ เราจะพิจารณาความแตกต่างในการใช้งานและ แต่ละเฟสของวงจรงาน ได้แก่ การสร้างงาน การส่งงานของนักเรียน/นักศึกษา และการให้คะแนน/ความคิดเห็น

ทำความเข้าใจวงจรของงาน

ก่อนที่จะไปดูความแตกต่างระหว่างปุ่มแชร์กับ CourseWork API มาดูกันก่อนว่าวงจรของงานในบริบทของ Classroom คืออะไร ซึ่งจะช่วยให้คุณเข้าใจวิธีที่ครูและนักเรียน โต้ตอบกับงานใน Classroom

มีขั้นตอนหลักๆ 5 ขั้นตอนที่ควรทราบขณะผสานรวมกับงานใน Classroom ดังนี้

  1. สร้างงานแล้ว
  2. แชร์งานกับนักเรียนแล้ว
  3. นักเรียนทำงานให้เสร็จ
  4. นักเรียนส่งงานให้ครู
  5. ครูตรวจและให้คะแนนงาน

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

แผนภาพแสดงขั้นตอน 5 ขั้นตอนในการสร้างงาน

การใช้งาน

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

<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>

ในทางกลับกัน CourseWork API เป็นส่วนหนึ่งของ Google Classroom API REST API ซึ่ง ต้องตั้งค่าและเปิดใช้คีย์ API ด้วยคอนโซล Google Cloud และ ทำตามแนวทางปฏิบัติแนะนำสำหรับการผสานรวมกับ API ปัญหานี้จะมีความกังวลน้อยลง หากแพลตฟอร์มของคุณใช้ฟังก์ชันอื่นๆ ของ Classroom API อยู่แล้ว เช่น การจัดกลุ่มผู้ใช้

การสร้างและแชร์งาน

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

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

ทั้ง 2 ข้อเสนอจะแสดงโพสต์ทุกประเภทใน Classroom ยกเว้นงานแบบทดสอบ ดูสรุปโพสต์ทุกประเภทและดูว่าโพสต์นั้นๆ แสดงต่อสาธารณะหรือไม่ได้ที่ด้านล่าง

ประเภทโพสต์ ปุ่มแชร์ CourseWork API
การมอบหมาย X X
งานแบบทดสอบ
คำถาม: คำตอบสั้นๆ X X
คำถาม: หลายตัวเลือก X X
วัสดุ X X
ประกาศ X X

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

การแก้ไขงาน

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

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

ซิงค์งานโดยอัตโนมัติ

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

การทำงานให้เสร็จและส่งงาน

งานแต่ละรายการจะเชื่อมโยงกับNงานที่นักเรียนส่ง โดยที่ N คือ จำนวนนักเรียนที่ได้รับมอบหมายงาน กล่าวคือ สำหรับงานแต่ละรายการ จะมีการส่งงานของนักเรียนที่เชื่อมโยงกับนักเรียนแต่ละคน ซึ่งสามารถเข้าถึงได้ด้วยรหัสที่ไม่ซ้ำกัน ระบบจะสร้างงานที่นักเรียนส่งเหล่านี้โดยอัตโนมัติ และแอปพลิเคชันของคุณจะเรียกข้อมูลได้ด้วยปลายทาง GET และ LIST ของงานที่นักเรียนส่ง

ทั้งปุ่มแชร์และ CourseWork API รองรับการเพิ่มลิงก์หรือไฟล์ลงใน งานที่นักเรียนส่ง ปุ่มแชร์ช่วยให้ทำเช่นนี้ได้ผ่าน เวิร์กโฟลว์ที่คล้ายกับกล่องโต้ตอบการสร้างงานของครู และ CourseWork API ผ่านปลายทาง studentSubmissions.modifyAttachments อย่างไรก็ตาม เนื่องจากข้อจำกัดด้านสิทธิ์ของ API ที่ระบุไว้ก่อนหน้านี้ ฟังก์ชันนี้จึงจำกัดเฉพาะรายการใน CourseWork ที่แอปพลิเคชันของคุณสร้างขึ้น แต่ข้อจำกัดเดียวกันนี้ไม่มีผลกับปุ่มแชร์ โดยนักเรียนจะเพิ่มงานของตนเองลงในงานใดก็ได้ที่เลือกจาก Classroom

สิ้นสุดเวิร์กโฟลว์ของนักเรียน/นักศึกษา

แม้ว่าการจำกัดสิทธิ์ใน CourseWork จะไม่ได้มีกรณีการใช้งานสำหรับ แพลตฟอร์มที่ไม่รองรับการสร้างงาน แต่ข้อดีอย่างหนึ่งคือ แพลตฟอร์มของบุคคลที่สามสามารถป้องกันไม่ให้นักเรียนส่งงานที่ไม่ถูกต้อง และลืมส่งงานได้ เนื่องจากมีการจำกัดเฉพาะปุ่มแชร์ไม่ให้นักเรียนส่งงาน

การตรวจและให้คะแนนงาน

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

ขณะนี้ปุ่มแชร์ยังไม่มีโซลูชันสำหรับการให้คะแนนและการส่งคืนงาน แม้ว่าขณะนี้จะยังไม่มีการแสดงฟีเจอร์ต่างๆ เช่น ความคิดเห็นในงานที่นักเรียนส่งผ่าน API แต่คุณก็ยังให้คะแนนและส่งคะแนนเหล่านั้นคืนให้นักเรียนได้ผ่านปลายทาง studentSubmissions.patch และ studentSubmissions.return คุณระบุคะแนนได้เฉพาะสำหรับรายการในสตรีมของ CourseWork (ประเภทงาน และคำถาม) โดยจะใช้ได้ในรูปแบบตัวเลขเท่านั้น และสามารถ กำหนดให้เป็นคะแนนฉบับร่างหรือคะแนนสุดท้ายก็ได้

สรุปความแตกต่าง

เพื่อสรุปทุกอย่างที่ตรวจสอบในส่วนก่อนหน้า ตารางด้านล่างจะแสดงการเปรียบเทียบปุ่มแชร์และ CourseWork API แบบเคียงข้างกันสำหรับ 4 หมวดหมู่ที่กล่าวถึงข้างต้น ได้แก่ การติดตั้งใช้งาน การสร้างและแชร์งาน การทำและส่งงาน รวมถึงการตรวจและให้คะแนนงาน

ปุ่มแชร์ CourseWork API
การใช้งาน ใช้ JavaScript เพียงไม่กี่บรรทัด ทำให้การติดตั้งใช้งานเป็นไปอย่างตรงไปตรงมาและ รวดเร็ว ต้องตั้งค่าคีย์ API, เปิดใช้ API ในคอนโซลผู้ดูแลระบบ และตรวจสอบอย่างใกล้ชิด ยิ่งขึ้น
การสร้างและแชร์งาน
  • เปลี่ยนเส้นทางครูไปยังกล่องโต้ตอบการแชร์ปุ่มแชร์ใน Classroom
  • ผู้ใช้โพสต์ได้ทุกประเภทรายการสตรีม ยกเว้น 1 ประเภท
  • ระบุฟิลด์ได้น้อยลง
  • โดยจะเปิดใช้การสร้างงาน แต่จะดึงหรือแก้ไขข้อมูลงานไม่ได้
  • กล่องโต้ตอบปุ่มแชร์ที่ไม่จำเป็น
  • ระบุฟิลด์งานใน Classroom ได้ส่วนใหญ่
  • ความสามารถในการแก้ไขหลักสูตรที่แอปพลิเคชันของคุณสร้างขึ้น
  • อนุญาตให้แอปดึงข้อมูลงานทั้งหมดจาก Classroom
การทำงานให้เสร็จและส่งงาน
  • เปลี่ยนเส้นทางนักเรียนไปยังกล่องโต้ตอบการแชร์ปุ่มแชร์ใน Classroom
  • อนุญาตให้นักเรียนแนบงานที่ส่งแล้วไปกับงานใน Classroom ได้
  • โดยจะเปิดใช้สิ่งที่แนบในการส่ง แต่จะดึงหรือแก้ไขข้อมูลการส่งไม่ได้
  • ไม่อนุญาตให้นักเรียนส่งงาน
  • กล่องโต้ตอบปุ่มแชร์ที่ไม่จำเป็น
  • อนุญาตให้นักเรียนแนบผลงานของตนเองกับงานที่สร้างโดยแอปของคุณเท่านั้น
  • อนุญาตให้แอปแก้ไขงานของนักเรียนที่แอปพลิเคชันของคุณสร้างขึ้น
  • อนุญาตให้นักเรียนส่งงาน
การตรวจและให้คะแนนงาน ไม่รองรับการระบุหรือส่งคืนคะแนน
  • อนุญาตให้แอปดึงข้อมูลงานที่นักเรียน/นักศึกษาส่งทั้งหมดจาก Classroom ในนามของครู
  • แสดงความสามารถในการมอบคะแนนให้นักเรียน/นักศึกษา ไม่ว่าจะเป็นคะแนนฉบับร่างหรือคะแนนสุดท้าย
  • แสดงความสามารถในการแก้ไขคะแนนของนักเรียน
  • แสดงความสามารถในการส่งคืนคะแนนให้นักเรียน