การดู สร้าง และแก้ไขงานใน Classroom
ฉันจะสร้างอะไรได้บ้างโดยใช้ปลายทางของ CourseWork ใน Classroom API
ปลายทางช่วยให้นักพัฒนาซอฟต์แวร์ดูและจัดการงานในชั้นเรียนได้ โดยเฉพาะอย่างยิ่ง คุณจะทำสิ่งต่อไปนี้ได้ทั้งหมด
- ดูงานและคำถาม (เรียกรวมกันว่า
CourseWork
) สำหรับผู้ใช้ - สร้าง แก้ไข และลบ
CourseWork
- แนบสื่อการเรียนการสอนของชั้นเรียน (ไฟล์ในไดรฟ์, วิดีโอ YouTube, ลิงก์) ไปยัง
CourseWork
- เปลี่ยนสถานะการส่งของนักเรียน (เช่น ส่งแล้ว ส่งคืนแล้ว รับคืนแล้ว)
- ตั้งค่าคะแนนสำหรับงานที่ส่ง
- แนบสื่อ (ไฟล์ในไดรฟ์, วิดีโอ YouTube, ลิงก์) ไปกับงานที่นักเรียนส่ง
ตัวอย่างกรณีการใช้งานสำหรับ CourseWork
- สมุดบันทึกคะแนน, SIS หรือระบบการรายงานสามารถซิงค์งานและคะแนนจาก Classroom ไปยังแอปพลิเคชันของตนได้ ซึ่งจะช่วยลดการโอนข้อมูลด้วยตนเอง
- แอปพลิเคชันการเรียนรู้สามารถสร้างงานใหม่ซึ่งจะปรากฏในสตรีมของชั้นเรียน เมื่อนักเรียนทำงานเสร็จแล้ว แอปพลิเคชันจะส่งงาน ให้คะแนน แนบงานของนักเรียน และจัดเก็บงานไว้ในโฟลเดอร์ไดรฟ์ที่เหมาะสมได้
- ผู้ใช้ที่เป็นครูสามารถสร้างงานที่มีไฟล์แนบของส่วนเสริมจากเว็บไซต์หรือแอปพลิเคชันของคุณ
- ผู้ใช้ที่เป็นนักเรียนจะส่งงานที่มีไฟล์แนบของส่วนเสริมได้
แอปพลิเคชันของฉันต้องมีสิทธิ์ใดบ้างในการสร้างหรือแก้ไขงาน
โดยทั่วไปแล้ว แอปพลิเคชันจะแก้ไขได้เฉพาะงานที่สร้างขึ้นเท่านั้น กล่าวคือ คำขอ API การเปลี่ยนแปลงงานทั้งหมดต้องใช้รหัสโปรเจ็กต์ Google Cloud เดียวกันกับที่เก็บไว้ ณ เวลาสร้างงาน
ส่วนเสริมของ Google Classroom มีข้อยกเว้นสำหรับกฎนี้ โปรเจ็กต์ใน Cloud สามารถเข้าถึงหรือแก้ไขประกาศ งาน หรือสื่อการเรียนการสอนของชั้นเรียนที่มีไฟล์แนบของส่วนเสริมอย่างน้อย 1 รายการ โปรเจ็กต์ในระบบคลาวด์ยังส่ง เรียกคืน หรือส่งคืนงานที่มีไฟล์แนบของส่วนเสริมอย่างน้อย 1 รายการได้ด้วย
นอกจากนี้ คำขอ API ยังต้องมีขอบเขตผู้ใช้ที่ถูกต้องด้วย ครูสามารถดู
งานที่มอบหมาย สร้างงาน แนบลิงก์ไปยังงานที่ส่ง และกำหนดคะแนนการส่งงาน นักเรียนสามารถดูงาน แนบลิงก์ไปยังบันทึกงาน รวมถึงส่งงานและอ้างสิทธิ์ซ้ำได้ ผู้ดูแลระบบโดเมนดู CourseWork
ได้ แต่ไม่มีสิทธิ์เขียน
ใบสมัครของฉันสามารถแนบรายการประเภทใดบ้างกับงานหรืองานที่ส่ง
API รองรับการแนบไฟล์ในไดรฟ์, วิดีโอ YouTube และ ลิงก์ต่างๆ ระบบยังไม่รองรับการแนบ Google Forms ในตัว
ผู้ใช้ปลายทางจะทราบหรือไม่ว่างานใน Classroom สร้างขึ้นโดยแอปพลิเคชันของฉัน
ได้ UI ของ Classroom จะระบุงานที่สร้างภายนอกโดยใช้ชื่อผลิตภัณฑ์ของโปรเจ็กต์ Google Cloud ที่สร้างงาน ผู้ใช้สามารถรายงานว่างานที่สร้างจากภายนอกไม่พึงประสงค์ รวมถึงยกเลิกการเชื่อมต่อแอปพลิเคชันที่สร้างงานดังกล่าวได้โดยการเพิกถอนข้อมูลเข้าสู่ระบบที่ผู้ใช้ออกให้แอปพลิเคชัน
ปุ่มแชร์ใน Classroom และการผสานรวมอื่นๆ
ฉันผสานรวมกับปุ่มแชร์ของ Classroom แล้ว ฉันจะแก้ไขงานที่สร้างขึ้นโดยใช้ปุ่มแชร์ได้ไหม
ยังไม่มี หากต้องการแก้ไขงาน คำขอต้องใช้โปรเจ็กต์ Google Cloud เดียวกันกับที่สร้างงาน
ฉันจะตอบคำถามใน API ได้ไหม
ยังไม่มี คุณสามารถสร้างและแก้ไขคำถามได้
ส่วนเสริมของ Classroom
การกำหนดค่าโปรเจ็กต์
ฉันจะแปลงโปรเจ็กต์ Google Cloud ส่วนตัวที่ใช้ระหว่างการพัฒนาเป็นโปรเจ็กต์สาธารณะที่ใช้ในเวอร์ชันที่ใช้งานจริงได้ไหม
คุณแปลงโปรเจ็กต์ Google Cloud ส่วนตัวเป็นโปรเจ็กต์สาธารณะไม่ได้ คุณต้องมีโปรเจ็กต์แยกกัน 2 โปรเจ็กต์ โปรเจ็กต์หนึ่งสำหรับการพัฒนาและอีกโปรเจ็กต์สำหรับเวอร์ชันที่ใช้งานจริง
โปรเจ็กต์ Google Cloud รายการเดียวมีข้อมูลผลิตภัณฑ์ใน Google Workspace Marketplace ได้ 2 รายการไหม
ไม่ได้ คุณไม่สามารถสร้างข้อมูลผลิตภัณฑ์ 2 รายการใน Google Workspace Marketplace สำหรับโปรเจ็กต์ Google Cloud รายการเดียว
อย่างไรก็ตาม คุณสามารถรวมส่วนเสริมได้ ซึ่งจะช่วยให้ข้อมูลผลิตภัณฑ์เดียวใน Google Workspace Marketplace แสดงถึงส่วนเสริมหลายรายการได้ การติดตั้งจากข้อมูลดังกล่าวจะติดตั้งส่วนเสริมทั้งหมดในแพ็กเกจพร้อมกัน ผู้ใช้จะต้องให้ความยินยอมในขอบเขตทั้งหมดที่จําเป็นสําหรับส่วนเสริมที่รวมอยู่ด้วยเมื่อให้สิทธิ์
ฉันนำไคลเอ็นต์ OAuth จากโปรเจ็กต์ Google Cloud อื่นมาใช้กับโปรเจ็กต์ Google Cloud สำหรับส่วนเสริมของ Classroom ได้ไหม
ไม่ได้ ไคลเอ็นต์ OAuth จากโปรเจ็กต์ Google Cloud อื่นนอกเหนือจากโปรเจ็กต์ Google Cloud ของส่วนเสริม Classroom จะใช้ไม่ได้ Classroom API จะปฏิเสธโทเค็นการเข้าถึงที่สร้างขึ้นโดยโปรเจ็กต์ Google Cloud อื่น คุณต้องสร้างไคลเอ็นต์ OAuth แยกต่างหากสำหรับโปรเจ็กต์ส่วนเสริม
ประสบการณ์ของผู้ใช้
โลโก้ของเราแสดงผลได้ไม่ดีนักภายในสี่เหลี่ยมจัตุรัสเล็ก โลโก้ในแถบชื่อ iframe จะมีตัวเลือกขนาดใดบ้าง
แถบชื่อ iframe ออกแบบมาเพื่อรองรับเฉพาะโลโก้สี่เหลี่ยมจัตุรัสขนาด 32x32 เท่านั้น ตัวเลือกนี้ทำขึ้นเพื่อให้ตรงกับรูปร่างของ Favicon ที่บริษัทใช้บนเว็บไซต์ของตน และเราขอแนะนำให้ใช้โลโก้เดียวกันในพื้นที่ดังกล่าวเพื่อให้แบรนด์มีความสอดคล้องกัน
โดเมน
ครูและนักเรียนทุกคนในโดเมนเดียวกันมีสิทธิ์เข้าถึงส่วนเสริมที่ติดตั้งไว้ไหม
ผู้ดูแลระบบของโรงเรียนควบคุมได้ว่าจะให้ครูคนใดเห็นส่วนเสริมที่ติดตั้งไว้ ส่วนเสริมของ Classroom จะใช้โดยผู้ใช้ที่มีใบอนุญาต Teaching and Learning หรือ Education Plus เท่านั้น
ผู้ดูแลระบบโดเมนโต้ตอบกับส่วนเสริมอย่างไร
ผู้ดูแลระบบโดเมน (ผู้ดูแลระบบ) จะเป็นผู้ควบคุมว่าใครจะใช้ส่วนเสริมของคุณได้ โดยสามารถติดตั้งส่วนเสริมสำหรับทั้งโดเมนได้โดยใช้ตัวเลือกการติดตั้งของผู้ดูแลระบบ หากส่วนเสริมของคุณติดตั้งทีละรายการได้ โปรดทราบว่าผู้ดูแลระบบส่วนใหญ่จะดูแลรักษารายการที่อนุญาตสำหรับส่วนเสริม โดยครูจะติดตั้งส่วนเสริมสำหรับตนเองได้หากอยู่ในรายการนี้ นอกจากนี้ ผู้ดูแลระบบอาจเลือกที่จะติดตั้งส่วนเสริมของคุณทีละรายการเพื่อวัตถุประสงค์ในการทดสอบด้วย
ผู้ดูแลระบบอาจสนใจสถิติการใช้งานเกี่ยวกับส่วนเสริมของคุณด้วย หากผลิตภัณฑ์รองรับ ให้พิจารณาแสดงสถิติการใช้งานส่วนเสริมในมุมมองผู้ดูแลระบบในเว็บไซต์ของคุณเอง
API
ข้อใดคือวิธีที่เชื่อถือได้ในการทราบว่าหน้าพาร์ทเนอร์โหลดขึ้นภายใน iframe หรือแท็บในหน้าต่างใหม่หรือไม่
ขณะนี้ยังไม่มีวิธีแยกความแตกต่างระหว่าง 2 รายการนี้
รายการงานที่กำหนดได้รายการใดบ้างที่มี iframe ของการตรวจสอบงานของนักเรียน
iframe ของตรวจงานของนักเรียนใช้ได้กับไฟล์แนบประเภทกิจกรรมเท่านั้น
เรียกเมธอด courses.courseWork.getAddOnContext
เพื่อดูว่าประเภทโพสต์รองรับงานของนักเรียนหรือไม่ ฟิลด์ supportsStudentWork
ต้องเป็น true
เท่านั้นสำหรับโพสต์ประเภทที่เป็นกิจกรรม
ไฟล์แนบของส่วนเสริมเข้าถึงรายการสตรีมที่แนบอยู่ได้ไหม
ได้ คุณจะget
หรือpatch
Announcement
, CourseWork
หรือ CourseWorkMaterial
ที่มีไฟล์แนบของส่วนเสริมอย่างน้อย 1 รายการก็ได้
คุณสามารถreclaim
, return
หรือ turnIn
CourseWork StudentSubmission
ได้
การลงชื่อเพียงครั้งเดียว
นักเรียนที่ใช้ป้าย Clever หรือ Classlink เพื่อลงชื่อเข้าใช้ Chromebook จะใช้ฟีเจอร์ลงชื่อเข้าใช้ด้วย Google ได้ไหม
ได้ บุตรหลานจะยังใช้ฟีเจอร์ลงชื่อเข้าใช้ด้วย Google ได้
นักเรียนทุกคนมีอีเมลที่มีรูปแบบถูกต้องไหม แม้ว่าจะไม่มีสิทธิ์เข้าถึง Gmail ก็ตาม
ผู้ใช้ Google Workspace for Education ทุกคนจะมีข้อมูลประจำตัวของ Google ไม่ว่าจะมีสิทธิ์เข้าถึง Gmail หรือไม่ก็ตาม ข้อมูลระบุตัวตนจะแสดงด้วยอีเมล ข้อมูลประจำตัวและการเข้าถึงบริการใดๆ ของ Google (รวมถึง Gmail) นั้นแตกต่างกัน ดังนั้น ผู้ใช้ที่เป็นนักเรียนจะลงชื่อเข้าใช้ด้วยอีเมลได้แม้ว่าจะปิดใช้ Gmail ก็ตาม
ผู้ดูแลระบบของโรงเรียนต้องอนุมัติแอปล่วงหน้าเพื่ออนุญาตให้นักเรียนลงชื่อเข้าใช้หรือไม่
ผู้ดูแลระบบโดเมนต้องเพิ่มลงในรายการที่อนุญาตก่อนจึงจะติดตั้งส่วนเสริมได้ ผู้ดูแลระบบโดเมนสามารถติดตั้งส่วนเสริมให้กับผู้ใช้ทุกคนภายในโดเมนหรือหน่วยขององค์กรได้ (ไม่บังคับ)
ความคิดเห็นและคำถามทั่วไป
ฉันจะส่งคำขอฟีเจอร์หรือปัญหาเกี่ยวกับคำขอได้อย่างไร
คุณสามารถส่ง ดู และโหวตคำขอฟีเจอร์ในเครื่องมือติดตามปัญหาสาธารณะ
ฉันจะรู้ได้อย่างไรว่า Classroom API มาพร้อมฟีเจอร์ใหม่ๆ เมื่อใด
การอัปเดต API จะได้รับการโพสต์ในหน้าบันทึกประจำรุ่น ฟอรัมสำหรับนักพัฒนาแอป และเครื่องมือติดตามปัญหาสาธารณะ
ฉันใช้ Classroom API ฉันจะถามคําถามทางเทคนิคได้อย่างไร
โพสต์คำถามใน Stack Overflow โดยใช้แท็ก google-classroom