Google Classroom поддерживает синхронизацию журнала оценок и импорт списка учащихся для ряда совместимых с OneRoster систем информации о студентах (SIS). Google сотрудничает с платформами SIS, которые соответствуют требованиям OneRoster, указанным Google.
Партнерство с Classroom предоставляет администраторам возможность подключать свои классы Classroom к вашей системе SIS.
Рисунок 1. Когда студенческие информационные системы (SIS) сотрудничают с Classroom, администраторы могут выбрать SIS в раскрывающемся списке.
Путь развития партнера SIS
Если вы заинтересованы в партнерстве с Classroom, заполните форму заинтересованности .
Команда Classroom создала набор тестов соответствия , которые заинтересованные партнеры SIS могут использовать для ознакомления с требованиями Google. У вас есть возможность запустить тесты соответствия, прежде чем обращаться в команду Classroom, чтобы определить, насколько ваш продукт соответствует требованиям Google.
Получите демо-домен для разработчиков
Вам может понадобиться доступ к живому экземпляру Google Classroom для создания и проверки интеграции. Соответствующим требованиям тестовым пользователям требуется версия Plus Google Workspace for Education . Если у вас нет доступа администратора к домену Google Workspace for Education с этими лицензиями, выполните шаги, чтобы получить тестовый домен разработчика и запросить обновление демонстрационного домена . Вашему домену будут предоставлены 10 лицензий Google Workspace for Education Plus.
Доступ и запуск тестов
Для проведения тестов вам понадобится следующее:
- URL-адрес токена для получения учетных данных OAuth 2.0
- Один URL-адрес списка, заканчивающийся на
/ims/oneroster/v1p1 - Идентификатор клиента
- Секрет клиента
- Адрес электронной почты учителя
Вы можете запустить тесты с помощью Google Colab или Jupyter notebook . Оба варианта Colab и Jupyter notebook позволяют вам запускать все тесты одновременно. Это помогает вам генерировать результаты тестов для передачи команде Google Classroom .
Требования SIS и ожидаемое поведение
Тесты, определенные Google, существуют для того, чтобы предоставить заинтересованным партнерам SIS способ определить, соответствует ли их продукт требованиям потребления OneRoster от Google, и минимизировать ошибки, которые могут возникнуть у пользователей при использовании интеграций SIS в Classroom. Прочитайте следующие указатели по тестам. В GitHub каждый тест имеет заголовок, на который ссылаются указатели. Имейте в виду, что указатели могут помочь прояснить вопросы, но это не полный список тестов. Убедитесь, что вы выполнили все тесты, предоставленные в GitHub.
| Тест | Указатели |
|---|---|
| Учителя: GetAllTeachers | Конечная точка GET /teachers вызывается с параметром запроса limit . В последующих тестах этот параметр используется для того, чтобы убедиться, что ваш продукт может поддерживать размер страницы 10 000. |
| Учителя: GetAllTeachers с фильтром электронной почты | Конечная точка GET /teachers вызывается с параметром запроса filter , используемым для фильтрации на основе адреса электронной почты учителя. Это будет использовать адрес электронной почты учителя, который вы указали в разделе Credentials тестов. |
| Классы: GetClassesForTeacher | Конечная точка /teachers/{teacher_sourced_id}/classes вызывается с параметром запроса filter используемым для фильтрации на основе активных классов. |
| Студенты: GetStudentsForClass | Вызывается конечная точка GET /classes/{class_sourced_id}/students . В ответе должен быть возвращен адрес электронной почты студента. |
| ПолучитьОценочныеПериодыЗаСеместр | Поддержка оценочных периодов тестируется с использованием term_sourced_id . Этот term_sourced_id используется для извлечения оценочных периодов в термине путем вызова конечной точки GET terms/{term_sourced_id}/gradingPeriods . |
| Элемент строки: Создать | При вызове PUT /lineItems/{line_item_sourced_id} оценочные периоды не требуются. |
| Элемент строки: Изменить | Вызов API не должен возвращать ошибку, если включена длинная длина заголовка назначения. Тест включает длину заголовка назначения 100+ символов. |
| Результат: Редактировать | Должна быть возможность установить score на значение, превышающее resultValueMax , для представления дополнительных баллов. |
| Результат: Удалить | Требуется конечная точка DELETE /results/{result_sourced_id} . |
| LineItem (Необязательно / Очистка): Удалить и получить | Конечная точка DELETE /lineItems/{line_item_sourced_id} не является обязательной. Она необязательна и используется для очистки данных. Последующая конечная точка GET /classes/{class_sourced_id}/lineItems также необязательна и проверяет, что элемент строки был удален. |
Поделитесь результатами теста с командой Google Classroom
После запуска тестов генерируется полный отчет с результатами каждого теста. Эти тесты используются для определения того, соответствует ли ваш продукт требованиям потребления OneRoster 1.2 от Google. Загрузите или сделайте снимок экрана сгенерированного отчета, чтобы поделиться им с командой Google Classroom.
Получить поддержку
Если у вас возникнут какие-либо вопросы, отправьте электронное письмо на адрес classroom-sis-external@google.com .