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 ของ One Roster ที่ลงท้ายด้วย /ims/oneroster/v1p1
  • รหัสลูกค้า
  • รหัสลับไคลเอ็นต์
  • อีเมลของครู

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

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

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

ทดสอบ เคล็ดลับ
ครู: GetAllTeachers ระบบจะเรียกใช้ปลายทาง GET /teachers ด้วยพารามิเตอร์การค้นหา limit ในการทดสอบครั้งต่อๆ ไป ระบบจะใช้พารามิเตอร์นี้เพื่อให้แน่ใจว่าผลิตภัณฑ์รองรับขนาดหน้าเว็บ 10,000 ได้
ครู: GetAllTeachers with email filter ระบบจะเรียกใช้ปลายทาง 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: แก้ไข การเรียก 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

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

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