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: สร้าง | ไม่จำเป็นต้องระบุระยะเวลาการให้คะแนนเมื่อเรียกใช้ 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