หากต้องการผสานรวม SIS กับ Classroom ให้ตรวจสอบว่าผลิตภัณฑ์ของคุณเป็นไปตามข้อกำหนดของการเป็นพาร์ทเนอร์ของ Classroom โดยเรียกใช้ชุดการทดสอบการปฏิบัติตามข้อกำหนดที่ระบุ
เข้าถึงและเรียกใช้การทดสอบ
คุณสามารถเข้าถึงการทดสอบการปฏิบัติตามข้อกำหนดได้ใน GitHub คุณต้องมีสิ่งต่อไปนี้จึงจะทำการทดสอบได้
- URL ของโทเค็นเพื่อดึงข้อมูลเข้าสู่ระบบ OAuth 2.0
- URL ของ One Roster ที่ลงท้ายด้วย
/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 ซึ่งใช้เพื่อกรองตามคลาสที่ใช้งานอยู่ |
| นักเรียน: GetStudentsForClass | เรียกปลายทาง 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 ใน GetAllClasses ด้วยการทดสอบตัวกรอง 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 หากมีคำถามหรือข้อกังวล