Bản xem trước tính năng và lộ trình

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.

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.

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: