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