แนะนำตัว

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

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

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

การทำความเข้าใจวงจรชีวิตของการมอบหมาย

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

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

  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 ทุกประเภท ยกเว้นงานแบบทดสอบ โปรดดูข้อมูลสรุปเกี่ยวกับโพสต์ทุกประเภทและตรวจสอบว่าโพสต์เหล่านั้นแสดงหรือไม่ที่ด้านล่าง

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

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

การแก้ไขงาน

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

CourseWork API จะช่วยแก้ไขและลบงานที่แอปพลิเคชันสร้างไว้ และยังเรียกรายละเอียดของงานที่โพสต์ไปยังหลักสูตรของผู้ใช้ได้ด้วย อย่างไรก็ตาม โปรดทราบว่ารายการใน CourseWork ไม่ได้สร้างโดย Developer Console เดียวกันจะไม่สามารถแก้ไขรายการใน 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 หมวดหมู่ที่กล่าวถึงข้างต้น ซึ่งได้แก่ การใช้งาน การสร้างและการแชร์งาน การทำงานให้เสร็จและการส่งงาน ตลอดจนการตรวจสอบและการให้คะแนนงาน

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