OneRoster สำหรับระบบข้อมูลของนักเรียน

Google Classroom รองรับการซิงค์สมุดพกและการนำเข้าบัญชีรายชื่อสำหรับระบบข้อมูลของนักเรียนนักศึกษา (SIS) ที่เป็นไปตามข้อกำหนด OneRoster จำนวนมาก Google ทำงานร่วมกับแพลตฟอร์ม SIS ที่เป็นไปตามข้อกำหนด OneRoster ที่ Google ระบุ

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

รูปที่ 1 เมื่อระบบข้อมูลของนักเรียนนักศึกษา (SIS) เป็นพาร์ทเนอร์กับ Classroom ผู้ดูแลระบบจะเลือก SIS ในเมนูแบบเลื่อนลงได้

เส้นทางการพัฒนาพาร์ทเนอร์ SIS

หากสนใจเป็นพาร์ทเนอร์กับ Classroom โปรดกรอก แบบฟอร์มแสดงความสนใจ

ทีม Classroom ได้สร้างชุดการทดสอบความสอดคล้องที่ พาร์ทเนอร์ SIS ที่สนใจสามารถใช้เพื่อทำความคุ้นเคยกับข้อกำหนดของ Google คุณมีตัวเลือกในการเรียกใช้การทดสอบความสอดคล้องก่อนที่จะติดต่อทีม Classroom เพื่อดูว่าผลิตภัณฑ์ของคุณเป็นไปตามข้อกำหนดของ Google มากน้อยเพียงใด

รับโดเมนสาธิตสำหรับนักพัฒนาซอฟต์แวร์

คุณอาจต้องการเข้าถึงอินสแตนซ์ Google Classroom จริงเพื่อสร้างและตรวจสอบการผสานรวม ผู้ใช้ทดสอบที่มีสิทธิ์ต้องใช้ Google Workspace for Education รุ่น Plus หากคุณไม่มีสิทธิ์เข้าถึงของผู้ดูแลระบบในโดเมน Google Workspace for Education ที่มีใบอนุญาตเหล่านี้ ให้ทำตามขั้นตอนเพื่อรับโดเมนทดสอบสำหรับนักพัฒนาซอฟต์แวร์และขออัปเกรดโดเมนสาธิต ระบบจะจัดสรรใบอนุญาต Google Workspace for Education Plus ให้โดเมนของคุณ 10 ใบ

เข้าถึงและเรียกใช้การทดสอบ

คุณต้องมีข้อมูลต่อไปนี้จึงจะเรียกใช้การทดสอบได้

  • URL ของโทเค็นเพื่อดึงข้อมูลเข้าสู่ระบบ OAuth 2.0
  • URL ของ OneRoster ที่ลงท้ายด้วย /ims/oneroster/v1p2
  • รหัสลูกค้า
  • รหัสลับไคลเอ็นต์
  • อีเมลของครู

คุณสามารถเรียกใช้การทดสอบได้โดยใช้ Google Colab หรือ สมุดบันทึก Jupyter ทั้ง Colab และสมุดบันทึก Jupyter ช่วยให้คุณเรียกใช้การทดสอบทั้งหมดได้พร้อมกัน ซึ่งจะช่วยให้คุณสร้างผลการทดสอบ เพื่อแชร์กับทีม Google Classroom ได้

ข้อกำหนดและลักษณะการทำงานที่คาดหวังของ SIS

การทดสอบที่ Google กำหนดขึ้นมีไว้เพื่อให้พาร์ทเนอร์ SIS ที่สนใจได้ทราบว่าผลิตภัณฑ์ของตนเป็นไปตามข้อกำหนดการใช้งาน OneRoster ของ Google หรือไม่ และเพื่อลดข้อผิดพลาดที่ผู้ใช้อาจพบเมื่อใช้การผสานรวม SIS ใน Classroom โปรดอ่านเคล็ดลับต่อไปนี้เกี่ยวกับการทดสอบ ใน GitHub การทดสอบแต่ละรายการจะมีชื่อที่อ้างอิงในเคล็ดลับ โปรดทราบว่าเคล็ดลับเหล่านี้ช่วยชี้แจงข้อสงสัยได้ แต่ไม่ใช่รายการการทดสอบทั้งหมด ตรวจสอบว่าคุณได้เรียกใช้การทดสอบทั้งหมดที่ระบุไว้ใน GitHub แล้ว

ทดสอบ เคล็ดลับ
ครู: GetAllTeachers ระบบจะเรียกปลายทาง GET /teachers ด้วยพารามิเตอร์การค้นหา limit ในการทดสอบครั้งต่อๆ ไป ระบบจะใช้พารามิเตอร์นี้เพื่อให้แน่ใจว่าผลิตภัณฑ์ของคุณรองรับขนาดหน้า 10,000 รายการ
ครู: GetAllTeachers พร้อมตัวกรองอีเมล ระบบจะเรียกปลายทาง GET /teachers ด้วยพารามิเตอร์การค้นหา filter ที่ใช้กรองตามอีเมลของครู ระบบจะใช้อีเมลของครูที่คุณระบุไว้ในส่วนข้อมูลเข้าสู่ระบบของการทดสอบ
ชั้นเรียน: GetClassesForTeacher ระบบจะเรียกปลายทาง /teachers/{teacher_sourced_id}/classes ด้วยพารามิเตอร์การค้นหา filter ที่ใช้กรองตามชั้นเรียนที่ใช้งานอยู่
นักเรียน: GetStudentsForClass ระบบจะเรียกปลายทาง GET /classes/{class_sourced_id}/students และต้องแสดงอีเมลของนักเรียนในคำตอบ
GetGradingPeriodsForTerm ระบบจะทดสอบการรองรับช่วงเวลาการให้คะแนนโดยใช้ term_sourced_id และใช้ term_sourced_id นี้เพื่อดึงข้อมูลช่วงเวลาการให้คะแนนในภาคเรียนโดยการเรียกปลายทาง GET terms/{term_sourced_id}/gradingPeriods
LineItem: Create ไม่จำเป็นต้องระบุช่วงเวลาการให้คะแนนเมื่อเรียก PUT /lineItems/{line_item_sourced_id}
LineItem: Edit การเรียก API ไม่ควรแสดงข้อผิดพลาดหากมีการระบุชื่อการมอบหมายที่ยาว การทดสอบนี้มีชื่อการมอบหมายที่มีความยาว 100 ตัวอักษรขึ้นไป
Result: Edit ควรตั้งค่า score เป็นค่าที่มากกว่า resultValueMax เพื่อแสดงคะแนนพิเศษได้
Result: Delete ต้องมีปลายทาง DELETE /results/{result_sourced_id}
LineItem (ไม่บังคับ / ล้างข้อมูล): Delete and Get ไม่จำเป็นต้องมีปลายทาง DELETE /lineItems/{line_item_sourced_id} แต่มีไว้สำหรับล้างข้อมูล นอกจากนี้ ปลายทาง GET /classes/{class_sourced_id}/lineItems ที่ตามมาก็ไม่บังคับเช่นกัน และใช้ทดสอบว่ามีการลบรายการบรรทัดแล้ว

แชร์ผลการทดสอบกับทีม Google Classroom

หลังจากเรียกใช้การทดสอบแล้ว ระบบจะสร้างรายงานฉบับเต็มพร้อมผลการทดสอบแต่ละรายการ การทดสอบเหล่านี้ใช้เพื่อพิจารณาว่าผลิตภัณฑ์ของคุณเป็นไปตามข้อกำหนดการใช้งาน OneRoster 1.2 ของ Google หรือไม่ ดาวน์โหลดหรือถ่ายภาพหน้าจอรายงานที่สร้างขึ้นเพื่อแชร์กับทีม Google Classroom

รับการสนับสนุน

หากมีคำถาม โปรดส่งอีเมลไปที่ classroom-sis-external@google.com