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: สร้าง ไม่จำเป็นต้องระบุช่วงเวลาการให้คะแนนเมื่อเรียก PUT /lineItems/{line_item_sourced_id}
LineItem: แก้ไข การเรียก API ไม่ควรแสดงข้อผิดพลาดหากมีการระบุความยาวชื่อการมอบหมายงานที่ยาว การทดสอบจะรวมความยาวชื่อการมอบหมายงาน 100 ตัวอักษรขึ้นไป
ผลลัพธ์: แก้ไข ควรตั้งค่า score เป็นค่าที่มากกว่า resultValueMax เพื่อแสดงคะแนนพิเศษได้
ผลลัพธ์: ลบ ต้องมีปลายทาง DELETE /results/{result_sourced_id}
LineItem (ไม่บังคับ / ล้างข้อมูล): ลบและรับ ไม่จำเป็นต้องมีปลายทาง DELETE /lineItems/{line_item_sourced_id} โดยเป็นตัวเลือกและใช้สำหรับการล้างข้อมูล ปลายทาง GET /classes/{class_sourced_id}/lineItems ที่ตามมาก็เป็นตัวเลือกเช่นกัน และจะทดสอบว่ามีการลบรายการบรรทัดแล้ว

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

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