Pour intégrer votre SIS à Classroom, vérifiez que votre produit respecte les conditions de partenariat de Classroom en exécutant l'ensemble de tests de conformité fournis.
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
- URL One Roster se terminant par
/ims/oneroster/v1p1 - ID client
- Code secret du client
- Adresse e-mail d'un enseignant
La suite de tests se compose de trois sections:
- Synchronisation de base des notes
- Catégories de note
- Périodes de notation
Vous pouvez exécuter les tests à l'aide de Google Colab ou d'un notebook Jupyter. Colab et le notebook Jupyter vous permettent d'exécuter tous les tests en même temps. Vous pouvez ainsi générer les résultats des tests à partager avec l'équipe Google Classroom.
Exigences concernant les SIS et comportement attendu
Les tests définis par Google ont pour but de maintenir la cohérence et de minimiser les erreurs que les utilisateurs peuvent rencontrer lorsqu'ils utilisent les intégrations de systèmes d'information scolaire (SIS) avec Classroom. Lisez les conseils suivants sur les tests. Sur GitHub, chaque test a un titre référencé dans les pointeurs. N'oubliez pas que les repères peuvent aider à clarifier les questions, mais qu'il ne s'agit pas d'une liste exhaustive des tests. Assurez-vous d'avoir exécuté tous les tests fournis sur GitHub.
Synchronisation de base des notes
| Test | Pointeurs |
|---|---|
| Enseignants: GetAllTeachers | Le point de terminaison GET /teachers est appelé avec un paramètre de requête limit. Dans les tests ultérieurs, ce paramètre permet de s'assurer que votre produit peut prendre en charge une taille de page de 10 000. |
| Enseignants: GetAllTeachers avec filtre par adresse e-mail | Le point de terminaison GET /teachers est appelé avec un paramètre de requête filter utilisé pour filtrer en fonction de l'adresse e-mail d'un enseignant. L'adresse e-mail de l'enseignant que vous avez indiquée dans la section "Identifiants" des tests sera utilisée. |
| Classes: GetClassesForTeacher | Le point de terminaison /teachers/{teacher_sourced_id}/classes est appelé avec un paramètre de requête filter utilisé pour filtrer en fonction des classes actives. |
| Élèves: GetStudentsForClass | Le point de terminaison GET /classes/{class_sourced_id}/students est appelé. L'adresse e-mail de l'élève doit être renvoyée dans la réponse. |
| LineItem: créer | Les catégories de notation ou les périodes de notation ne sont pas obligatoires lorsque vous appelez PUT /lineItems/{line_item_sourced_id}. |
| LineItem: Edit | L'appel d'API ne doit pas renvoyer d'erreur si un titre de devoir long est inclus. Le titre du devoir doit comporter au moins 100 caractères. |
| Résultat: Modification | Il devrait être possible de définir score sur une valeur supérieure à resultValueMax pour représenter des points supplémentaires. |
| Résultat : "Delete" (Supprimer) | Le point de terminaison DELETE /results/{result_sourced_id} est obligatoire. |
| Élément de campagne (facultatif / nettoyage): supprimer et récupérer | Le point de terminaison DELETE /lineItems/{line_item_sourced_id} n'est pas obligatoire. Il est facultatif et sert à nettoyer les données. Le point de terminaison GET /classes/{class_sourced_id}/lineItems suivant est également facultatif et vérifie que l'élément de campagne a été supprimé. |
Catégories de notes
| Test | Pointeurs |
|---|---|
| GetAllCategories ou GetCategoriesForClass | Un seul point de terminaison GET /categories est requis, GetAllCategories ou GetCategoriesForClass. Mettez en commentaire celui que vous n'utilisez pas si vous exécutez tous les tests en même temps. |
| DeleteLineItem (facultatif / nettoyage) | Le test DeleteLineItem est facultatif et peut être utilisé pour nettoyer les données. |
Périodes de notation
| Test | Pointeurs |
|---|---|
| GetGradingPeriodsForTerm | La prise en charge des périodes de notation est testée en récupérant le term_sourced_id dans le test GetAllClasses avec filtre. Cette term_sourced_id permet de récupérer les périodes de notation du semestre en appelant le point de terminaison GET terms/{term_sourced_id}/gradingPeriods dans le test GetGradingPeriodsForTerm. |
Partager les résultats du test 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 de Google pour OneRoster 1.1. Téléchargez ou prenez une capture d'écran du rapport généré. Envoyez le rapport et un lien vers la certification OneRoster 1.1 de votre produit par e-mail à l'adresse [email protected].
Obtenir de l'aide
Envoyez un e-mail à [email protected] si vous avez des questions.