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