ตรวจสอบว่า SIS เป็นไปตามข้อกำหนดของ Google Classroom

หากต้องการผสานรวม 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 ระบบจะอ้างอิงชื่อเหล่านี้ใน ตัวชี้

  1. สิ่งที่ควรทราบเกี่ยวกับส่วนการซิงค์เกรดพื้นฐานมีดังนี้

    • ในการทดสอบ 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} ขั้นตอนนี้เป็นแบบไม่บังคับและใช้เพื่อการล้างข้อมูล

  2. สิ่งที่ควรทราบเกี่ยวกับส่วนหมวดหมู่คะแนนและระยะเวลาการให้คะแนนมีดังนี้

    • ต้องการปลายทาง 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