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