Kiểm tra để đảm bảo rằng hệ thống thông tin học sinh (SIS) của bạn đáp ứng các yêu cầu của Google Lớp học

Để tích hợp SIS với Lớp học, hãy xác thực rằng sản phẩm của bạn đáp ứng các yêu cầu đối với đối tác của Lớp học bằng cách chạy bộ kiểm thử tuân thủ được cung cấp.

Truy cập và chạy chương trình kiểm thử

Bạn có thể truy cập các bài kiểm thử tính tuân thủ trên GitHub. Để chạy các chương trình kiểm thử, bạn cần có:

  • URL mã thông báo để truy xuất thông tin xác thực OAuth 2.0
  • URL One Roster có đuôi là /ims/oneroster/v1p1
  • ID khách hàng
  • Mật khẩu ứng dụng khách
  • Địa chỉ email của giáo viên

Bộ kiểm thử có 3 phần:

  • Đồng bộ hoá điểm cơ bản
  • Danh mục chấm điểm
  • Giai đoạn chấm điểm

Bạn có thể chạy các chương trình kiểm thử bằng cách sử dụng Google Colab hoặc sổ tay Jupyter. Cả Colab và sổ tay Jupyter đều cho phép bạn chạy tất cả các kiểm thử cùng một lúc. Thao tác này giúp bạn tạo kết quả kiểm thử để chia sẻ với nhóm Google Lớp học.

Yêu cầu về SIS và hành vi dự kiến

Các bài kiểm thử do Google xác định được tạo ra để duy trì tính nhất quán và giảm thiểu lỗi mà người dùng có thể gặp phải khi sử dụng các tính năng tích hợp SIS với Google Lớp học. Đọc qua các gợi ý sau đây về kiểm thử. Trong GitHub, mỗi bài kiểm thử đều có một tiêu đề được tham chiếu trong con trỏ. Xin lưu ý rằng các con trỏ có thể giúp làm rõ các câu hỏi, nhưng đây không phải là danh sách đầy đủ các bài kiểm thử. Đảm bảo bạn đã chạy tất cả các bài kiểm thử được cung cấp trong GitHub.

Đồng bộ hoá điểm cơ bản

Thử nghiệm Con trỏ
Giáo viên: GetAllTeachers Điểm cuối GET /teachers được gọi bằng tham số truy vấn limit. Trong các lần kiểm thử tiếp theo, tham số này được dùng để đảm bảo rằng sản phẩm của bạn có thể hỗ trợ kích thước trang là 10.000.
Giáo viên: GetAllTeachers có bộ lọc email Điểm cuối GET /teachers được gọi bằng tham số truy vấn filter dùng để lọc dựa trên địa chỉ email của giáo viên. Email này sẽ sử dụng địa chỉ email của giáo viên mà bạn đã cung cấp trong phần Thông tin xác thực của bài kiểm tra.
Lớp: GetClassesForTeacher Điểm cuối /teachers/{teacher_sourced_id}/classes được gọi bằng tham số truy vấn filter dùng để lọc dựa trên các lớp đang hoạt động.
Học viên: GetStudentsForClass Điểm cuối GET /classes/{class_sourced_id}/students được gọi. Email của học viên phải được trả về trong phản hồi.
Mục hàng: Tạo Bạn không bắt buộc phải có danh mục chấm điểm hoặc giai đoạn chấm điểm khi gọi PUT /lineItems/{line_item_sourced_id}.
LineItem: Edit Lệnh gọi API không được trả về lỗi nếu đã đưa độ dài của tiêu đề bài tập vào. Bài kiểm thử có tiêu đề bài tập dài hơn 100 ký tự.
Kết quả: Chỉnh sửa Bạn có thể đặt score thành một giá trị lớn hơn resultValueMax để thể hiện điểm thưởng.
Kết quả: Xoá Bạn phải có điểm cuối DELETE /results/{result_sourced_id}.
LineItem (Không bắt buộc / Dọn dẹp): Xoá và Lấy Bạn không bắt buộc phải sử dụng điểm cuối DELETE /lineItems/{line_item_sourced_id}. Đây là thuộc tính không bắt buộc và dùng để dọn dẹp dữ liệu. Điểm cuối GET /classes/{class_sourced_id}/lineItems tiếp theo cũng là không bắt buộc và kiểm thử để đảm bảo mục hàng đã bị xoá.

Danh mục chấm điểm

Thử nghiệm Con trỏ
GetAllCategories hoặc GetCategoriesForClass Bạn chỉ cần một điểm cuối GET /categories, đó là GetAllCategories hoặc GetCategoriesForClass. Chú thích dòng bạn không sử dụng nếu chạy tất cả các bài kiểm thử cùng một lúc.
DeleteLineItem (Không bắt buộc / Dọn dẹp) Kiểm thử DeleteLineItem là không bắt buộc và có thể được sử dụng để làm sạch dữ liệu.

Giai đoạn chấm điểm

Thử nghiệm Con trỏ
GetGradingPeriodsForTerm Hỗ trợ giai đoạn chấm điểm được kiểm thử bằng cách truy xuất term_sourced_id trong GetAllClasses bằng kiểm thử bộ lọc. term_sourced_id này dùng để truy xuất các giai đoạn chấm điểm trong học kỳ bằng cách gọi điểm cuối GET terms/{term_sourced_id}/gradingPeriods trong kiểm thử GetGradingPeriodsForTerm.

Chia sẻ kết quả kiểm thử với nhóm Google Lớp học

Sau khi bạn chạy các chương trình kiểm thử, một báo cáo đầy đủ với kết quả của từng chương trình kiểm thử sẽ được tạo. Các bài kiểm thử này được dùng để xác định xem sản phẩm của bạn có đáp ứng các yêu cầu về việc sử dụng OneRoster 1.1 của Google hay không. Tải hoặc chụp ảnh màn hình báo cáo đã tạo. Gửi báo cáo và đường liên kết đến chứng chỉ OneRoster 1.1 của sản phẩm đến classroom-sis-external@google.com.

Yêu cầu hỗ trợ

Hãy gửi email đến classroom-sis-external@google.com nếu có câu hỏi hoặc mối lo ngại.