Pour intégrer votre SIS à Classroom, vérifiez que votre produit répond aux exigences de partenariat de Classroom en exécutant l'ensemble de tests de conformité fourni.
Accéder aux tests et les exécuter
Vous pouvez accéder aux tests de conformité sur GitHub. Pour exécuter les tests, vous avez besoin des éléments suivants:
- URL du jeton permettant de récupérer les identifiants OAuth 2.0
- Une URL de liste se terminant par
/ims/oneroster/v1p1
- ID client
- Client secret (Code secret du client)
- L'adresse e-mail d'un enseignant
La suite de tests comporte trois sections:
- Synchronisation basique des notes
- Catégories de notes
- Périodes de notation
Vous pouvez exécuter les tests à l'aide de Google Colab ou du notebook Jupyter. Colab et le notebook Jupyter vous permettent d'exécuter tous les tests en même temps. Cela vous permet de générer les résultats des tests à partager avec l'équipe Google Classroom.
Conditions requises pour le SIS et comportement attendu
Les tests définis par Google ont pour but de maintenir la cohérence et de réduire les erreurs que les utilisateurs peuvent rencontrer lorsqu'ils utilisent les intégrations de SIS avec Classroom. Lisez les conseils suivants sur les tests. Dans GitHub, chaque test est marqué avec @title
. Ces titres sont référencés dans les pointeurs.
Prenez note des points suivants à propos de la section Synchronisation de base des notes:
Dans le test
GetAllTeachers
, le point de terminaisonGET /teachers
est appelé avec un paramètre de requêtelimit=
. Dans les tests ultérieurs, ce paramètre permet de s'assurer que votre produit peut accepter une taille de page de 10 000.Dans le test
GetAllTeachers with email filter
, le point de terminaisonGET /teachers
est appelé avec un paramètre de requêtefilter=
permettant de filtrer en fonction de l'adresse e-mail d'un enseignant. Vous devez spécifier une adresse e-mail d'enseignant lorsque vous exécutez les tests.Dans le test
GetClassesForTeacher
, le point de terminaison/teachers/{teacher_sourced_id}/classes
est appelé avec un paramètre de requêtefilter=
permettant de filtrer en fonction des classes actives.Dans le test
GetStudentsForClass
, le point de terminaisonGET /classes/{class_sourced_id}/students?limit=10000
est appelé. L'adresse e-mail de l'élève doit être renvoyée dans la réponse.Dans le test
PutLineItem Create
, les catégories de notes ou les périodes de notation ne sont pas requises lorsque vous appelezPUT /lineItems/{line_item_sourced_id}
.Dans le test
PutLineItem Edit
, l'appel d'API ne doit pas renvoyer d'erreur si le titre d'un devoir est long. Le titre du devoir comporte plus de 100 caractères.Dans le test
PutResult Edit
, il devrait être possible de définirscore
sur une valeur supérieure àresultValueMax
pour représenter un crédit supplémentaire.Le point de terminaison
DELETE /results/{result_sourced_id}
est requis et testé lors du testDeleteResult
.Le point de terminaison
DELETE /lineItems/{line_item_sourced_id}
n'est pas requis. Il est facultatif et utilisé pour le nettoyage des données.
Notez les points suivants à propos des sections Catégories de notes et Périodes de notation:
- Un seul point de terminaison
GET /categories
est requis. Mettez en commentaire celui que vous n'utilisez pas si vous effectuez tous les tests de conformité en même temps :/categories?limit=10000
/classes/{class_sourced_id}/categories?limit=10000
- La prise en charge des périodes de notation est testée en récupérant
term_sourced_id
dans le testGetAllClasses w/ filter
. Cet élémentterm_sourced_id
permet de récupérer les périodes de notation pour le terme en appelant le point de terminaisonGET terms/{term_sourced_id}/gradingPeriods?limit=10000
dans le testGetGradingPeriodsForTerm
.
- Un seul point de terminaison
Partager les résultats des tests avec l'équipe Google Classroom
Une fois les tests exécutés, un rapport complet contenant les résultats de chaque test est généré. Ces tests permettent de déterminer si votre produit répond aux exigences de consommation OneRoster 1.1 de Google. Téléchargez le rapport généré ou faites-en une capture d'écran. Envoyez le rapport par e-mail ainsi qu'un lien vers la certification OneRoster 1.1 de votre produit à l'adresse classroom-sis-external@google.com.
Obtenir de l'aide
Si vous avez des questions ou des inquiétudes, envoyez un e-mail à classroom-sis-external@google.com.