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