พาร์ทเนอร์ SIS ที่สนใจสามารถใช้การทดสอบการปฏิบัติตามข้อกำหนดใน GitHub เพื่อระบุว่าผลิตภัณฑ์ของตนเป็นไปตามข้อกำหนดในการใช้งาน OneRoster ของ Google Classroom หรือไม่
เข้าถึงและเรียกใช้การทดสอบ
คุณต้องมีสิ่งต่อไปนี้จึงจะทำการทดสอบได้
- URL ของโทเค็นเพื่อดึงข้อมูลเข้าสู่ระบบ OAuth 2.0
- URL ของ One Roster ที่ลงท้ายด้วย
/ims/oneroster/v1p1 - รหัสลูกค้า
- รหัสลับไคลเอ็นต์
- อีเมลของครู
คุณสามารถเรียกใช้การทดสอบได้โดยใช้ 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 |
| รายการโฆษณา: สร้าง | คุณไม่จำเป็นต้องระบุระยะเวลาการให้คะแนนเมื่อเรียกใช้ PUT /lineItems/{line_item_sourced_id} |
| รายการโฆษณา: แก้ไข | การเรียก 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.1 ของ Google หรือไม่ ดาวน์โหลดหรือถ่ายภาพหน้าจอของรายงานที่สร้างขึ้นเพื่อแชร์กับทีม Google Classroom
รับการสนับสนุน
ส่งอีเมลไปที่ classroom-sis-external@google.com หากมีคำถามหรือข้อกังวล