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