Les partenaires SIS intéressés peuvent utiliser les tests de conformité sur GitHub pour déterminer si leur produit répond aux exigences de consommation de OneRoster de Google Classroom.
Accéder aux tests et les exécuter
Pour exécuter les tests, vous avez besoin des éléments suivants:
- URL du jeton pour 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
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 permettent aux partenaires de systèmes d'information scolaire (SIS) intéressés de déterminer si leur produit répond aux exigences de consommation de OneRoster de Google et de réduire les erreurs que les utilisateurs peuvent rencontrer lorsqu'ils utilisent les intégrations de SIS dans Classroom. Lisez les conseils suivants sur les tests. Dans GitHub, chaque test est associé à 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.
| 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 de messagerie | 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. |
| GetGradingPeriodsForTerm | La prise en charge des périodes de notation est testée à l'aide de term_sourced_id. Cet élément 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. |
| LineItem: créer | Les périodes de notation ne sont pas obligatoires lors de l'appel de 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 de l'exercice comporte plus de 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 utilisé pour le nettoyage des 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é. |
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 de Google pour OneRoster 1.1. Téléchargez ou prenez une capture d'écran du rapport généré pour le partager avec l'équipe Google Classroom.
Obtenir de l'aide
Envoyez un e-mail à l'adresse classroom-sis-external@google.com si vous avez des questions ou des préoccupations.