Vérifier que votre SIS respecte les exigences de Google Classroom

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.

  1. Prenez note des points suivants à propos de la section Synchronisation de base des notes:

    • Dans le test 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 accepter une taille de page de 10 000.

    • Dans le test GetAllTeachers with email filter, le point de terminaison GET /teachers est appelé avec un paramètre de requête filter= 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ête filter= permettant de filtrer en fonction des classes actives.

    • Dans le test GetStudentsForClass, le point de terminaison GET /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 appelez PUT /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éfinir score 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 test DeleteResult.

    • 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.

  2. 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 test GetAllClasses w/ filter. Cet élément term_sourced_id permet de récupérer les périodes de notation pour le terme en appelant le point de terminaison GET terms/{term_sourced_id}/gradingPeriods?limit=10000 dans le test GetGradingPeriodsForTerm.

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.