Trang này cung cấp thông tin về các tính năng sắp ra mắt cho API Lớp học và thông tin chi tiết về cách tham gia bản dùng thử cho nhà phát triển.
Xem trước API Lớp học
Việc xem trước các tính năng của API Lớp học mang đến cơ hội cho nhà phát triển ảnh hưởng đến hình thức phát triển tính năng bằng ý kiến phản hồi và sẵn sàng tích hợp để sử dụng công khai trước khi phát hành rộng rãi.
Vòng đời xem trước
Nhà phát triển có thể chọn sử dụng các phiên bản API chứa các tính năng mới, tương thích ngược. Những "bản xem trước" này được phát hành công khai trong ít nhất 90 ngày. Tuỳ thuộc vào ý kiến phản hồi, phiên bản xem trước và các tính năng của phiên bản đó sẽ được đưa vào API v1 hiện có. Các phiên bản xem trước sẽ vẫn hoạt động trong ít nhất 90 ngày nữa trước khi ngừng hoạt động.
Nếu ý kiến phản hồi về phiên bản xem trước đủ mạnh để yêu cầu thay đổi có thể gây lỗi, thì một phiên bản mới sẽ được tạo để hỗ trợ các chức năng hiện có. Cả hai phiên bản đều có sẵn trong ít nhất 90 ngày để cho phép nhà phát triển di chuyển. Hãy tham gia danh sách gửi thư Bản dùng thử API Lớp học dành cho nhà phát triển để nắm bắt thông tin về các thay đổi trong bản dùng thử và đăng ký danh sách thông báo để nhận thông tin cập nhật chung hơn về API Lớp học.
Tham gia bản dùng thử API Lớp học
Để tham gia, hãy tham gia Chương trình xem trước dành cho nhà phát triển của Google Workspace. Các tính năng xem trước công khai hiện có được liệt kê trong bản dùng thử đang hoạt động dành cho nhà phát triển của Google Workspace. Nếu đang thử nghiệm một tính năng xem trước riêng tư, bạn có thể không thấy tính năng đó được liệt kê trong bất kỳ tài liệu công khai nào.
Các tính năng sắp ra mắt
Đây là lộ trình của chúng tôi về các tính năng API dự kiến và tiến trình triển khai các tính năng đó. Danh sách này được cập nhật định kỳ.
Giá trị phiên bản xem trước thể hiện ngày dự kiến cho bản xem trước ban đầu của phiên bản. Hãy xem phần Truy cập vào API xem trước để tìm hiểu cách sử dụng các phiên bản xem trước.
| Tính năng | Mô tả | Mục tiêu xem trước | Mục tiêu cho GA | Phiên bản của bản xem trước |
|---|---|---|---|---|
| Giai đoạn chấm điểm | Thay mặt quản trị viên và giáo viên tạo, đọc, cập nhật và xoá giai đoạn chấm điểm. | Nửa đầu năm 2024 | TBD |
V1_20240401_PREVIEW |
| Chức năng của người dùng | Kiểm tra xem người dùng có quyền sử dụng một số tính năng nhất định của Lớp học hay không. | Quý 4 năm 2024 | Nửa đầu năm 2025 | V1_20240930_PREVIEW |
Các phiên bản trước
Sau khi các tính năng mới được xác thực, tính năng đó sẽ được đưa vào API v1 và phiên bản xem trước tương ứng sẽ bị tắt. Nhà phát triển có ít nhất 90 ngày để di chuyển trước khi phiên bản xem trước ngừng hoạt động.
| Tính năng | Mô tả | Được tích hợp vào GA | Ngày ngừng hoạt động của bản xem trước mục tiêu | Phiên bản của bản xem trước |
|---|---|---|---|---|
| Rubrics CRUD | Thay mặt giáo viên tạo, đọc, cập nhật và xoá thang điểm trong lớp học. | Ngày 5 tháng 12 năm 2024 | Ngày 1 tháng 4 năm 2025 | V1_20231110_PREVIEW |
Hướng dẫn di chuyển
Sau khi các tính năng của phiên bản xem trước được tích hợp vào API v1, hãy xoá đối số previewVersion khỏi các lệnh gọi API có liên quan để đảm bảo rằng ứng dụng của bạn tiếp tục hoạt động như mong đợi. Ví dụ: nếu bạn đang sử dụng các tính năng tạo tiêu chí đánh giá được giới thiệu trong phiên bản V1_20231110_PREVIEW, thì lệnh gọi API của bạn có thể có dạng như sau:
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
# Specify the preview version. Rubrics CRUD capabilities are
# supported in V1_20231110_PREVIEW and later.
previewVersion="V1_20231110_PREVIEW"
).execute()
Để di chuyển sang API GA phiên bản 1, hãy xoá đối số previewVersion:
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
).execute()
Nếu bạn đang sử dụng thư viện ứng dụng được tạo tĩnh dành riêng cho việc truy cập vào một tính năng của phiên bản xem trước nhất định và không sử dụng các tính năng API xem trước khác, hãy chuyển sang thư viện ứng dụng mặc định cho ngôn ngữ của bạn. Hãy xem bài viết Truy cập API xem trước để tìm hiểu thêm.
Phản hồi
Chia sẻ ý kiến phản hồi về các tính năng xem trước thông qua IssueTracker được liên kết trong phần bản dùng thử đang hoạt động dành cho nhà phát triển trên trang tổng quan về Chương trình dùng thử cho nhà phát triển của Google Workspace.
Sử dụng các tính năng xem trước của API Lớp học trong phiên bản chính thức
Nếu muốn sử dụng các tính năng xem trước API Lớp học với người dùng cuối, bao gồm cả giáo viên, quản trị viên hoặc học viên thực sự, bạn phải đồng ý với nội dung sửa đổi dành riêng cho Lớp học đối với Điều khoản của Chương trình xem trước dành cho nhà phát triển của Google Workspace bằng cách hoàn tất và gửi biểu mẫu này: