หากต้องการผสานรวม SIS กับ Classroom ให้ตรวจสอบว่าผลิตภัณฑ์ของคุณเป็นไปตามข้อกำหนดของการเป็นพาร์ทเนอร์ของ Classroom โดยเรียกใช้ชุดการทดสอบการปฏิบัติตามข้อกำหนดที่ระบุ
เข้าถึงและทำการทดสอบ
คุณสามารถเข้าถึงการทดสอบการปฏิบัติตามข้อกำหนดได้ใน GitHub ในการทำการทดสอบ คุณต้องมีสิ่งต่อไปนี้
- URL ของโทเค็นเพื่อดึงข้อมูลเข้าสู่ระบบ OAuth 2.0
- URL Roster 1 รายการที่ลงท้ายด้วย
/ims/oneroster/v1p1 - รหัสลูกค้า
- รหัสลับไคลเอ็นต์
- อีเมลของครู
ชุดทดสอบมี 3 ส่วน ได้แก่
- การซิงค์คะแนนพื้นฐาน
- หมวดหมู่การให้คะแนน
- ระยะเวลาการให้คะแนน
คุณสามารถเรียกใช้การทดสอบได้โดยใช้ Google Colab หรือสมุดบันทึก Jupyter ทั้ง Colab และสมุดบันทึก Jupyter ให้คุณเรียกใช้การทดสอบทั้งหมดพร้อมกันได้ ซึ่งจะช่วยให้คุณสร้างผลการทดสอบเพื่อแชร์กับทีม Google Classroom ได้
ข้อกำหนดของ SIS และลักษณะการทำงานที่คาดไว้
การทดสอบที่ Google กำหนดมีไว้เพื่อรักษาความสอดคล้องและลดข้อผิดพลาดที่ผู้ใช้อาจพบเมื่อใช้การผสานรวม SIS กับ Classroom อ่านคำแนะนำต่อไปนี้เกี่ยวกับการทดสอบ ใน GitHub การทดสอบแต่ละรายการจะมีชื่อที่ใช้อ้างอิงในเคอร์เซอร์ โปรดทราบว่าเคอร์เซอร์ช่วยชี้แจงคำถามได้ แต่ไม่ใช่รายการทดสอบที่ครอบคลุม ตรวจสอบว่าคุณได้ทำการทดสอบทั้งหมดที่ให้ไว้ใน GitHub แล้ว
การซิงค์คะแนนพื้นฐาน
| ทดสอบ | เคอร์เซอร์ |
|---|---|
| ครู: GetAllTeachers | ระบบจะเรียกปลายทาง GET /teachers ด้วยพารามิเตอร์การค้นหาของ limit ในการทดสอบครั้งต่อๆ ไป ระบบจะใช้พารามิเตอร์นี้เพื่อให้แน่ใจว่าผลิตภัณฑ์รองรับขนาดหน้าเว็บ 10,000 |
| ครู: GetAllTeachers ที่มีตัวกรองอีเมล | ระบบจะเรียกใช้ปลายทาง GET /teachers ด้วยพารามิเตอร์การค้นหาของ filter ที่ใช้กรองตามอีเมลของครู ซึ่งจะใช้อีเมลของครูที่คุณระบุไว้ในส่วนข้อมูลเข้าสู่ระบบของแบบทดสอบ |
| ชั้นเรียน: GetClassesForTeacher | ระบบจะเรียกใช้ปลายทาง /teachers/{teacher_sourced_id}/classes ด้วยพารามิเตอร์การค้นหาของ filter ที่ใช้กรองตามคลาสที่ใช้งานอยู่ |
| นักเรียน: GetStudentForClass | ระบบเรียกปลายทาง GET /classes/{class_sourced_id}/students ระบบต้องแสดงอีเมลของนักเรียนในการตอบกลับ |
| รายการโฆษณา: สร้าง | คุณไม่จำเป็นต้องระบุหมวดหมู่การให้คะแนนหรือระยะเวลาการให้คะแนนเมื่อเรียกใช้ 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 ที่ตามมาก็เป็นตัวเลือกที่ไม่บังคับเช่นกัน และทดสอบว่ารายการโฆษณาถูกลบแล้ว |
หมวดหมู่การให้คะแนน
| ทดสอบ | เคอร์เซอร์ |
|---|---|
| GetAllCategories หรือ GetCategoriesForClass | ต้องใช้ปลายทาง GET /categories เพียงรายการเดียวเท่านั้น ซึ่งได้แก่ GetAllCategories หรือ GetCategoriesForClass แสดงความคิดเห็นเกี่ยวกับรายการที่คุณไม่ใช้ หากเรียกใช้การทดสอบทั้งหมดพร้อมกัน |
| DeleteLineItem (ไม่บังคับ / ล้างข้อมูล) | การทดสอบ DeleteLineItem เป็นตัวเลือกและสามารถใช้เพื่อล้างข้อมูล |
ระยะเวลาการให้คะแนน
| ทดสอบ | เคอร์เซอร์ |
|---|---|
| GetGradingPeriodsForTerm | ระบบจะทดสอบการรองรับระยะเวลาการให้คะแนนโดยการดึงข้อมูล term_sourced_id ใน GetAllClass ที่มีการทดสอบตัวกรอง term_sourced_id นี้ใช้เพื่อเรียกข้อมูลระยะเวลาการให้คะแนนในเทอมโดยการเรียกใช้ปลายทาง GET terms/{term_sourced_id}/gradingPeriods ในการทดสอบ GetGradingPeriodsForTerm |
แชร์ผลการทดสอบกับทีม Google Classroom
หลังจากทำการทดสอบแล้ว ระบบจะสร้างรายงานฉบับเต็มที่มีผลการทดสอบแต่ละรายการ การทดสอบเหล่านี้ใช้เพื่อระบุว่าผลิตภัณฑ์ของคุณเป็นไปตามข้อกำหนดการบริโภค OneRoster 1.1 ของ Google หรือไม่ ดาวน์โหลดหรือจับภาพหน้าจอของรายงานที่สร้างขึ้น ส่งรายงานและลิงก์ไปยังการรับรอง OneRoster 1.1 ของผลิตภัณฑ์ทางอีเมลไปที่ classroom-sis-external@google.com
รับการสนับสนุน
ส่งอีเมลไปที่ classroom-sis-external@google.com หากมีคำถามหรือข้อกังวล