Google Classroom поддерживает синхронизацию журналов оценок и импорт расписания занятий для ряда совместимых с OneRoster систем информации об учащихся (SIS). Google сотрудничает с платформами SIS, которые соответствуют требованиям OneRoster, установленным Google.
Партнерство с Classroom предоставляет администраторам возможность подключать свои классы Classroom к вашей системе SIS.
Рисунок 1. Когда студенческая информационная система (SIS) сотрудничает с Classroom, администраторы могут выбрать SIS в раскрывающемся списке.
Путь развития партнера SIS
Если вы заинтересованы в партнерстве с Classroom, заполните форму заинтересованности .
Команда Classroom разработала набор тестов соответствия , которые заинтересованные партнёры SIS могут использовать для ознакомления с требованиями Google. Вы можете провести тесты соответствия, прежде чем обращаться к команде Classroom, чтобы определить, насколько ваш продукт соответствует требованиям Google.
Получите демо-домен для разработчиков
Вам может потребоваться доступ к работающему экземпляру Google Класса для создания и проверки интеграции. Для участия в тестировании требуется версия 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 возможность определить, соответствует ли их продукт требованиям Google к использованию OneRoster, и минимизировать ошибки, которые могут возникнуть у пользователей при использовании интеграций SIS в Classroom. Ознакомьтесь со следующими указаниями по тестам. В GitHub каждый тест имеет название, на которое ссылаются указатели. Имейте в виду, что указатели могут помочь прояснить вопросы, но не являются полным списком тестов. Убедитесь, что вы выполнили все тесты, предоставленные в GitHub.
| Тест | Указатели |
|---|---|
| Учителя: GetAllTeachers | Конечная точка GET /teachers вызывается с параметром запроса limit . В последующих тестах этот параметр используется для проверки того, что ваш продукт поддерживает размер страницы 10 000. |
| Учителя: GetAllTeachers с фильтром электронной почты | Конечная точка GET /teachers вызывается с параметром запроса filter , который используется для фильтрации по адресу электронной почты преподавателя. Будет использоваться адрес электронной почты преподавателя, указанный вами в разделе «Учётные данные» тестов. |
| Классы: GetClassesForTeacher | Конечная точка /teachers/{teacher_sourced_id}/classes вызывается с параметром запроса filter используемым для фильтрации на основе активных классов. |
| Студенты: GetStudentsForClass | Вызывается конечная точка GET /classes/{class_sourced_id}/students . В ответе должен быть возвращен адрес электронной почты студента. |
| GetGradingPeriodsForTerm | Поддержка оценочных периодов тестируется с помощью term_sourced_id . Этот term_sourced_id используется для получения оценочных периодов в термине путем вызова конечной точки GET terms/{term_sourced_id}/gradingPeriods . |
| LineItem: Создать | При вызове PUT /lineItems/{line_item_sourced_id} оценочные периоды не требуются. |
| LineItem: Изменить | Вызов API не должен возвращать ошибку, если указано длинное название задания. Тест включает название задания длиной более 100 символов. |
| Результат: Редактировать | Должна быть возможность установить score на значение, превышающее resultValueMax , для предоставления дополнительных баллов. |
| Результат: Удалить | Требуется конечная точка DELETE /results/{result_sourced_id} . |
| LineItem (Необязательно / Очистка): Удалить и получить | Конечная точка DELETE /lineItems/{line_item_sourced_id} не является обязательной. Она необязательна и используется для очистки данных. Последующая конечная точка GET /classes/{class_sourced_id}/lineItems также необязательна и проверяет, была ли удалена позиция. |
Поделитесь результатами теста с командой Google Classroom
После проведения тестов формируется полный отчёт с результатами каждого теста. Эти тесты используются для определения соответствия вашего продукта требованиям Google OneRoster 1.2 к использованию. Скачайте или сделайте снимок экрана с отчётом, чтобы поделиться им с командой Google Класса.
Получить поддержку
По всем вопросам пишите на адрес classroom-sis-external@google.com .