Google Lớp học hỗ trợ tính năng đồng bộ hoá sổ điểm và nhập danh sách cho một số Hệ thống thông tin học sinh (SIS) tuân thủ OneRoster. Google hợp tác với các nền tảng SIS đáp ứng các yêu cầu về OneRoster do Google chỉ định.
Việc hợp tác với Lớp học giúp quản trị viên có thể kết nối các lớp học trong Lớp học với SIS của bạn.
Hình 1. Khi Hệ thống thông tin học sinh (SIS) hợp tác với Lớp học, quản trị viên có thể chọn SIS trong trình đơn thả xuống.
Hành trình phát triển đối tác SIS
Nếu bạn muốn hợp tác với Lớp học, hãy điền vào biểu mẫu bày tỏ sự quan tâm.
Nhóm Lớp học đã tạo một bộ kiểm thử mức độ tuân thủ mà các đối tác SIS quan tâm có thể sử dụng để làm quen với các yêu cầu của Google. Bạn có thể chạy các bài kiểm thử mức độ tuân thủ trước khi liên hệ với nhóm Lớp học để xác định mức độ đáp ứng các yêu cầu của Google đối với sản phẩm của bạn.
Nhận miền bản minh hoạ dành cho nhà phát triển
Bạn có thể muốn truy cập vào một thực thể Google Lớp học đang hoạt động để xây dựng và xác thực quá trình tích hợp. Người dùng thử nghiệm đủ điều kiện cần có phiên bản Plus của Google Workspace for Education. Nếu bạn không có quyền quản trị đối với một miền Google Workspace for Education có các giấy phép này, hãy hoàn tất các bước để nhận miền thử nghiệm dành cho nhà phát triển và yêu cầu nâng cấp miền bản minh hoạ. Miền của bạn sẽ được cấp 10 giấy phép Google Workspace for Education Plus.
Truy cập và chạy các bài kiểm thử
Để chạy các bài kiểm thử, bạn cần có những thông tin sau:
- URL mã thông báo để truy xuất thông tin xác thực OAuth 2.0
- URL OneRoster kết thúc bằng
/ims/oneroster/v1p2 - ID khách hàng
- Khoá bí mật của ứng dụng khách
- Địa chỉ email của giáo viên
Bạn có thể chạy các bài 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 bài kiểm thử cùng một lúc. Điều 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à hành vi dự kiến của SIS
Các bài kiểm thử do Google xác định tồn tại để cung cấp cho các đối tác SIS quan tâm một cách xác định xem sản phẩm của họ có đáp ứng các yêu cầu về mức tiêu thụ OneRoster của Google hay không và để giảm thiểu các 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 trong Lớp học. Hãy đọc kỹ các điểm sau đây về các bài kiểm thử. Trong GitHub, mỗi bài kiểm thử có một tiêu đề được tham chiếu trong các điểm. Xin lưu ý rằng các điểm 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.
| 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 bài 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. Tham số 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 các bài kiểm thử. |
| Lớp học: 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 học đ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. |
| GetGradingPeriodsForTerm | Tính năng hỗ trợ kỳ tính điểm được kiểm thử bằng cách sử dụng term_sourced_id. term_sourced_id này được dùng để truy xuất các kỳ tính điểm trong kỳ bằng cách gọi điểm cuối GET terms/{term_sourced_id}/gradingPeriods. |
| LineItem: Create | Không bắt buộc phải có kỳ tính đ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 tiêu đề bài tập dài được đưa vào. Bài kiểm thử bao gồm tiêu đề bài tập có độ dài từ 100 ký tự trở lên. |
| Kết quả: Chỉnh sửa | Bạn có thể đặt score thành một giá trị lớn hơn resultValueMax để biểu thị đ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à Nhận | Bạn không bắt buộc phải có điểm cuối DELETE /lineItems/{line_item_sourced_id}. Điểm cuối này là không bắt buộc và được 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ử rằng mục hàng đã bị xoá. |
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 bài kiểm thử, một báo cáo đầy đủ với kết quả của từng bài 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ề mức tiêu thụ OneRoster 1.2 của Google hay không. Tải báo cáo đã tạo xuống hoặc chụp ảnh màn hình báo cáo đó để chia sẻ với nhóm Google Lớp học.
Yêu cầu hỗ trợ
Hãy gửi email đến classroom-sis-external@google.com nếu bạn có thắc mắc.