Убедитесь, что ваша SIS соответствует требованиям Google Classroom.

Чтобы интегрировать свою СИУ с Classroom, убедитесь, что ваш продукт соответствует партнерским требованиям Classroom, выполнив предоставленный набор тестов на соответствие .

Доступ и запуск тестов

Вы можете получить доступ к тестам соответствия на GitHub. Для запуска тестов необходимо следующее:

• URL-адрес токена для получения учетных данных OAuth 2.0
• Один URL-адрес реестра, заканчивающийся на /ims/oneroster/v1p1
• ID клиента
• Секрет клиента
• Адрес электронной почты учителя

В наборе тестов есть три раздела:

• Базовая синхронизация оценок
• Категории оценок
• Оценочные периоды

Вы можете запустить тесты с помощью Google Colab или блокнота Jupyter . И Colab, и блокнот Jupyter позволяют запускать все тесты одновременно. Это поможет вам генерировать результаты тестов и делиться ими с командой Google Classroom .

Требования SIS и ожидаемое поведение

Тесты, определенные Google, существуют для обеспечения согласованности и минимизации ошибок, которые могут возникнуть у пользователей при использовании интеграции SIS с Классом. Прочтите следующие указания по тестам. В GitHub каждый тест отмечен @title . Эти заголовки упоминаются в указателях.

Важно! Ниже приведены несколько советов, которые помогут вам интегрироваться с Классом. Используйте результаты испытаний на соответствие, чтобы убедиться в выполнении требований.

1. Обратите внимание на следующее относительно раздела «Базовая синхронизация оценок »:

   • В тесте GetAllTeachers конечная точка GET /teachers вызывается с параметром запроса limit= . В последующих тестах этот параметр используется для того, чтобы убедиться, что ваш продукт поддерживает размер страницы 10 000.

   • В тесте GetAllTeachers with email filter конечная точка GET /teachers вызывается с параметром запроса filter= , используемым для фильтрации на основе адреса электронной почты учителя. При выполнении тестов необходимо указать адрес электронной почты преподавателя.

   • В тесте GetClassesForTeacher конечная точка /teachers/{teacher_sourced_id}/classes вызывается с параметром запроса filter= , используемым для фильтрации на основе активных классов.

   • В тесте GetStudentsForClass вызывается конечная точка GET /classes/{class_sourced_id}/students?limit=10000 . Электронная почта студента должна быть возвращена в ответе.

   • В тесте PutLineItem Create категории оценок или периоды оценки не требуются при вызове PUT /lineItems/{line_item_sourced_id} .

   • В тесте PutLineItem Edit вызов API не должен возвращать ошибку, если включен длинный заголовок назначения. Тест включает заголовок задания длиной более 100 символов.

   • В тесте PutResult Edit должна быть возможность установить score на значение, большее, чем resultValueMax , чтобы представить дополнительные баллы.

   • Конечная точка DELETE /results/{result_sourced_id} является обязательной и проверена в тесте DeleteResult .

   • Конечная точка DELETE /lineItems/{line_item_sourced_id} не требуется. Это необязательно и используется для очистки данных.

2. Обратите внимание на следующее относительно разделов «Категории оценок» и «Оценочные периоды» .

   • Требуется только одна конечная точка GET /categories . Закомментируйте тот, который вы не используете, если запускаете все тесты на соответствие одновременно:
     • /categories?limit=10000
     • /classes/{class_sourced_id}/categories?limit=10000
   • Поддержка оценочных периодов проверяется путем получения term_sourced_id в тесте GetAllClasses w/ filter . Этот term_sourced_id используется для получения оценочных периодов в семестре путем вызова конечной GET terms/{term_sourced_id}/gradingPeriods?limit=10000 в тесте GetGradingPeriodsForTerm .

Поделитесь результатами теста с командой Google Classroom

После запуска тестов генерируется полный отчет с результатами каждого теста. Эти тесты используются, чтобы определить, соответствует ли ваш продукт требованиям Google OneRoster 1.1 к использованию. Загрузите или сделайте скриншот созданного отчета. Отправьте отчет и ссылку на сертификацию OneRoster 1.1 вашего продукта по адресу [e-mail] .

Получать поддержку

Если у вас возникнут вопросы или проблемы, отправьте электронное письмо по адресу [e-mail] .