หากต้องการผสานรวม SIS กับ Classroom โปรดตรวจสอบว่าผลิตภัณฑ์ของคุณเป็นไปตามข้อกำหนดการเป็นพาร์ทเนอร์ของ Classroom โดยใช้ชุดการทดสอบความสอดคล้องที่จัดเตรียมไว้ให้
เข้าถึงและทำการทดสอบ
คุณเข้าถึงการทดสอบความสอดคล้องได้ใน GitHub คุณต้องมีสิ่งต่อไปนี้เพื่อทำการทดสอบ
- URL ของโทเค็นเพื่อเรียกข้อมูลเข้าสู่ระบบ OAuth 2.0
- URL บัญชีรายชื่อ 1 รายการที่ลงท้ายด้วย
/ims/oneroster/v1p1
- Client-ID
- รหัสลับไคลเอ็นต์
- อีเมลของครู
ชุดทดสอบจะมี 3 ส่วนดังต่อไปนี้
- การซิงค์เกรดพื้นฐาน
- หมวดหมู่คะแนน
- ระยะเวลาการให้คะแนน
คุณทำการทดสอบได้โดยใช้ Google Colab หรือสมุดบันทึก Jupyter ทั้ง Colab และสมุดบันทึก Jupyter ช่วยให้คุณทำการทดสอบทั้งหมดพร้อมกันได้ การดำเนินการนี้จะช่วยสร้างผลการทดสอบเพื่อแชร์กับทีม Google Classroom
ข้อกำหนดของ SIS และลักษณะการทำงานที่คาดไว้
การทดสอบที่ Google กำหนดนั้นมีไว้เพื่อรักษาความสอดคล้องและลดข้อผิดพลาดที่ผู้ใช้อาจพบเมื่อใช้การผสานรวม SIS กับ Classroom อ่านคำแนะนำเกี่ยวกับการทดสอบต่อไปนี้ การทดสอบแต่ละรายการจะมีเครื่องหมาย @title
กำกับอยู่ใน 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?limit=10000
อีเมลของนักเรียนต้องส่งคืนมาในการตอบกลับในการทดสอบ
PutLineItem Create
คุณไม่จำเป็นต้องระบุหมวดหมู่เกรดหรือระยะเวลาการให้คะแนนเมื่อเรียกใช้PUT /lineItems/{line_item_sourced_id}
ในการทดสอบ
PutLineItem Edit
การเรียก API ไม่ควรแสดงผลข้อผิดพลาดหากมีการระบุความยาวของชื่องานที่ใช้เวลานาน การทดสอบจะมีชื่องานที่มีความยาวมากกว่า 100 อักขระในการทดสอบ
PutResult Edit
ควรตั้งค่าscore
ให้มากกว่าresultValueMax
ได้เพื่อแสดงถึงเครดิตเพิ่มเติมปลายทาง
DELETE /results/{result_sourced_id}
เป็นสิ่งที่จำเป็นและทดสอบในการทดสอบDeleteResult
ไม่จำเป็นต้องมีปลายทาง
DELETE /lineItems/{line_item_sourced_id}
ขั้นตอนนี้เป็นแบบไม่บังคับและใช้เพื่อการล้างข้อมูล
สิ่งที่ควรทราบเกี่ยวกับส่วนหมวดหมู่คะแนนและระยะเวลาการให้คะแนนมีดังนี้
- ต้องการปลายทาง
GET /categories
เพียง 1 รายการเท่านั้น แสดงความคิดเห็นของข้อที่คุณ ไม่ได้ใช้งานหากทำการทดสอบความสอดคล้องทั้งหมดพร้อมกัน/categories?limit=10000
/classes/{class_sourced_id}/categories?limit=10000
- ระบบจะทดสอบการรองรับระยะเวลาการให้คะแนนโดยการดึงข้อมูล
term_sourced_id
ในการทดสอบGetAllClasses w/ filter
term_sourced_id
นี้ใช้เพื่อดึงระยะเวลาการให้คะแนนในคำนั้นๆ โดยเรียกใช้ปลายทางGET terms/{term_sourced_id}/gradingPeriods?limit=10000
ในการทดสอบGetGradingPeriodsForTerm
- ต้องการปลายทาง
แชร์ผลการทดสอบกับทีม Google Classroom
หลังจากทำการทดสอบแล้ว ระบบจะสร้างรายงานฉบับเต็มที่มีผลการทดสอบแต่ละครั้ง การทดสอบเหล่านี้ใช้เพื่อระบุว่าผลิตภัณฑ์ของคุณเป็นไปตาม ข้อกำหนดด้านการใช้งาน OneRoster 1.1 ของ Google หรือไม่ ดาวน์โหลดหรือจับภาพหน้าจอ ของรายงานที่สร้างขึ้น ส่งอีเมลรายงานและลิงก์ไปยังใบรับรอง OneRoster 1.1 ของผลิตภัณฑ์ไปที่ classroom-sis-external@google.com
รับความช่วยเหลือ
หากมีข้อสงสัยหรือข้อกังวลใดๆ โปรดส่งอีเมลถึง classroom-sis-external@google.com