На этой странице содержится информация о предстоящих функциях Classroom API и подробности о том, как принять участие в предварительном просмотре для разработчиков.
Предварительный просмотр API класса
Предварительный просмотр функций Classroom API дает разработчикам возможность влиять на ход разработки функций с помощью отзывов и подготавливать интеграции для публичного использования до того, как они станут общедоступными.
Предварительный просмотр жизненного цикла
Разработчики могут подписаться на версии API, содержащие новые, обратно совместимые функции. Эти «предварительные версии» доступны публично не менее 90 дней. При условии получения отзывов предварительная версия и её функции затем включаются в существующий API v1. Предварительные версии остаются доступными не менее 90 дней, после чего прекращают свою работу.
Если отзывы о предварительной версии настолько обширны, что требуют внесения критических изменений, создаётся новая версия для поддержки существующих возможностей. Обе версии доступны не менее 90 дней, что позволяет разработчикам перейти на новую версию. Подпишитесь на рассылку Classroom API Developer Preview, чтобы быть в курсе изменений предварительной версии, и подпишитесь на рассылку объявлений, чтобы получать более общие обновления Classroom API.
Примите участие в предварительных версиях Classroom API
Чтобы принять участие, присоединитесь к программе Google Workspace Developer Preview . Доступные функции общедоступной предварительной версии перечислены в разделе активных предварительных версий Google Workspace для разработчиков . Если вы тестируете функцию закрытой предварительной версии, она может не быть указана в общедоступной документации.
Предстоящие функции
Это наш план ожидаемых функций API и сроки их реализации. Он периодически обновляется.
Значение предварительной версии представляет собой ожидаемую дату первоначальной доступности предварительной версии. Подробнее об использовании предварительных версий см. в разделе API Access .
| Особенность | Описание | Цель для предварительного просмотра | Цель для GA | Предварительная версия |
|---|---|---|---|---|
| Возможности пользователя | Проверьте, имеет ли пользователь доступ к определенным функциям Classroom. | 4 квартал 2024 года | 2025 H1 | V1_20240930_PREVIEW |
| Студенческие группы | Управлять студенческими группами и их членами от имени администраторов и преподавателей. | 3 квартал 2025 года | Будет определено | V1_20250630_PREVIEW |
Предыдущие версии
После проверки новых функций они включаются в API v1, а соответствующая предварительная версия закрывается. У разработчиков есть не менее 90 дней на миграцию, прежде чем предварительная версия будет закрыта.
| Особенность | Описание | Включено в GA | Целевая дата закрытия предварительного просмотра | Предварительная версия |
|---|---|---|---|---|
| Рубрики CRUD | Создавайте, читайте, обновляйте и удаляйте классные рубрики от имени учителей. | 2024 Декабрь 05 | 1 апреля 2025 г. | V1_20231110_PREVIEW |
| Периоды оценки | Создавайте, читайте, обновляйте и удаляйте оценочные периоды от имени администраторов и преподавателей. | 8 апреля 2025 г. | 1 августа 2025 г. | V1_20240401_PREVIEW |
Руководство по миграции
После интеграции функций из предварительной версии в API v1 удалите аргумент previewVersion из связанных вызовов API, чтобы ваше приложение продолжало работать ожидаемым образом. Например, если вы обращались к возможностям создания рубрик, представленным в версии V1_20231110_PREVIEW , ваши вызовы API могли выглядеть следующим образом:
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()
Чтобы перейти на API v1 GA, удалите аргумент previewVersion :
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
).execute()
Если вы использовали статически сгенерированную клиентскую библиотеку специально для доступа к определённой предварительной версии функции и не используете другие функции API предварительной версии, перейдите на клиентскую библиотеку по умолчанию для вашего языка. Подробнее см. в разделе API предварительной версии Access .
Обратная связь
Поделитесь своими отзывами о функциях предварительной версии через связанный IssueTracker в разделе активных предварительных версий для разработчиков на странице обзора программы предварительной версии Google Workspace Developer Preview.
Используйте функции предварительной версии Classroom API в рабочей среде
Если вы хотите использовать функции предварительной версии API Classroom с конечными пользователями, включая настоящих преподавателей, администраторов или студентов, вам необходимо согласиться с поправкой к условиям программы Google Workspace Developer Preview , касающейся Classroom, заполнив и отправив эту форму: