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

Trang này chứa thông tin về các tính năng sắp ra mắt của Classroom API 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 dùng thử các tính năng của API Lớp học giúp nhà phát triển có cơ hội tác động đến quá trình phát triển tính năng thông qua ý kiến phản hồi và chuẩn bị sẵn các tính nă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 của bản xem trước

Nhà phát triển có thể chọn sử dụng các phiên bản API có chứa các tính năng mới, tương thích ngược. Các "phiên bản xem trước" này được cung cấp 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 này sẽ được tích hợp 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ề một phiên bản xem trước đủ mạnh để yêu cầu thay đổi mang tính đột phá, 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. Tham gia danh sách gửi thư Bản dùng thử cho nhà phát triển Classroom API để nắm bắt thông tin về các thay đổi trong bản dùng thử và đăng ký tham gia danh sách thông báo để nhận thông tin cập nhật chung hơn về Classroom API.

Tham gia chương trình dùng thử trước Classroom API

Để tham gia, hãy đăng ký Chương trình dùng thử trước dành cho nhà phát triển của Google Workspace. Các tính năng bản dùng thử 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 đó 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 dự kiến của API và thời gian triển khai. 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 có bản xem trước ban đầu của phiên bản. Hãy xem phần Truy cập vào API dùng thử để tìm hiểu cách sử dụng các phiên bản dùng thử.

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 tích hợp vào API phiên bản 1 và phiên bản xem trước tương ứng sẽ ngừng hoạt động. 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 trong 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 ứng dụng của bạn tiếp tục hoạt động như mong đợi. Ví dụ: nếu bạn đang truy cập vào các chức năng tạo bảng điểm được giới thiệu trong phiên bản V1_20231110_PREVIEW, thì các lệnh gọi API của bạn có thể trô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 một 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 phiên bản dùng thử nhất định và không sử dụng các tính năng API dùng thử 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 phần Truy cập vào API xem trước để tìm hiểu thêm.

Phản hồi

Chia sẻ ý kiến phản hồi của bạn về các tính năng dùng thử 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 Google Workspace.

Sử dụng các tính năng dùng thử của API Lớp học trong môi trường sản xuất

Nếu muốn sử dụng các tính năng xem trước của Classroom API 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 tế), bạn phải đồng ý với một bản 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 Google Workspace bằng cách hoàn tất và gửi biểu mẫu này: