Чтобы интегрировать свою СИУ с Classroom, убедитесь, что ваш продукт соответствует партнерским требованиям Classroom, выполнив предоставленный набор тестов на соответствие .
Доступ и запуск тестов
Вы можете получить доступ к тестам соответствия на GitHub. Для запуска тестов необходимо следующее:
- URL-адрес токена для получения учетных данных OAuth 2.0
- Один URL-адрес реестра, заканчивающийся на
/ims/oneroster/v1p1 - Идентификатор клиента
- Секрет клиента
- Адрес электронной почты учителя
В наборе тестов есть три раздела:
- Базовая синхронизация оценок
- Категории оценок
- Оценочные периоды
Вы можете запустить тесты с помощью Google Colab или блокнота Jupyter . И Colab, и блокнот Jupyter позволяют запускать все тесты одновременно. Это поможет вам генерировать результаты тестов и делиться ими с командой Google Classroom .
Требования SIS и ожидаемое поведение
Тесты, определенные Google, существуют для обеспечения согласованности и минимизации ошибок, которые могут возникнуть у пользователей при использовании интеграции SIS с Классом. Прочтите следующие указания по тестам. В 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 . Электронная почта студента должна быть возвращена в ответе. |
| СтрокаЭлемент: Создать | Категории оценки или периоды оценки не требуются при вызове 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 также является необязательной и проверяет, что позиция была удалена. |
Категории оценок
| Тест | Указатели |
|---|---|
| GetAllCategories или GetCategoriesForClass | Требуется только одна конечная точка GET /categories : GetAllCategories или GetCategoriesForClass. Закомментируйте тот, который вы не используете, если запускаете все тесты одновременно. |
| Удалитьлинеитем (необязательно/очистка) | Тест DeleteLineItem не является обязательным и может использоваться для очистки данных. |
Оценочные периоды
| Тест | Указатели |
|---|---|
| GetGradingPeriodsForTerm | Поддержка оценочных периодов проверяется путем получения term_sourced_id в тесте GetAllClasses с фильтром. Этот term_sourced_id используется для получения оценочных периодов в семестре путем вызова конечной точки GET terms/{term_sourced_id}/gradingPeriods в тесте GetGradingPeriodsForTerm. |
Поделитесь результатами теста с командой Google Classroom
После запуска тестов генерируется полный отчет с результатами каждого теста. Эти тесты используются, чтобы определить, соответствует ли ваш продукт требованиям Google OneRoster 1.1 к использованию. Загрузите или сделайте скриншот созданного отчета. Отправьте отчет и ссылку на сертификацию OneRoster 1.1 вашего продукта по адресу class-sis-external@google.com .
Получить поддержку
Если у вас возникнут вопросы или проблемы, отправьте электронное письмо по адресу class-sis-external@google.com .