Pour intégrer votre SIS à Classroom, vérifiez que votre produit répond aux conditions de partenariat de Classroom en exécutant d'un 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 devez ont besoin des éléments suivants:
- URL du jeton permettant de récupérer les identifiants OAuth 2.0
- Une URL de la liste d'élèves se terminant par
/ims/oneroster/v1p1 - ID client
- Code secret du client
- Adresse e-mail d'un enseignant
La suite de tests comporte trois sections:
- Synchronisation de base des notes
- Catégories de notes
- Périodes de notation
Vous pouvez exécuter les tests à l'aide de Google Colab ou d'un notebook Jupyter. Les deux Colab et le notebook Jupyter vous permettent d'exécuter tous les tests en même temps. Cela vous aide à générer les résultats du test pour partager la présentation avec l'équipe Google Classroom.
Exigences SIS et comportement attendu
Les tests définis par Google permettent de maintenir la cohérence et de minimiser erreurs que les utilisateurs peuvent rencontrer lors de l'utilisation d'intégrations de SIS avec Classroom. Lisez les conseils suivants sur les tests. Dans GitHub, chaque test possède un titre référencé dans les pointeurs. À retenir que les indications permettent de clarifier certaines questions, mais qu'elles ne constituent pas une liste exhaustive des tests. Assurez-vous d'avoir exécuté tous les tests fournis dans 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 suivants, ce paramètre permet de s'assurer que votre produit peut accepter une taille de page de 10 000. |
| Enseignants: GetAllTeachers avec filtre d'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 permettant de 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. |
| Élément de campagne: créer | Il n'est pas nécessaire de définir des catégories ou des périodes de notation lorsque vous appelez PUT /lineItems/{line_item_sourced_id}. |
| Élément de campagne: modification | L'appel d'API ne doit pas renvoyer d'erreur si le titre du devoir est long. Le titre du devoir doit comporter au moins 100 caractères. |
| Résultat: Modifier | Vous pouvez définir score sur une valeur supérieure à resultValueMax pour représenter un crédit supplémentaire. |
| Résultat: suppression | Veuillez indiquer le point de terminaison DELETE /results/{result_sourced_id}. |
| Élément de campagne (facultatif / nettoyage): supprimer et récupérer | Le point de terminaison DELETE /lineItems/{line_item_sourced_id} n'est pas requis. Facultatif et utilisé pour le nettoyage des données Le point de terminaison GET /classes/{class_sourced_id}/lineItems ultérieur 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 le nettoyage des 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 term_sourced_id dans GetAllClasses avec un test de filtre. Ce term_sourced_id permet de récupérer les périodes de notation du terme 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
Après avoir exécuté les tests, un rapport complet contenant les résultats de chacun d'eux est généré. Ces tests permettent de déterminer si votre produit respecte Exigences d'utilisation de Google OneRoster 1.1. Télécharger ou prendre une capture d'écran du rapport généré. Envoyez le rapport par e-mail, accompagné d'un lien vers l'e-mail la certification OneRoster 1.1 à classroom-sis-external@google.com.
Obtenir de l'aide
Envoyez un e-mail à classroom-sis-external@google.com si vous avez des questions ou des problèmes.