Google Classroom est compatible avec la synchronisation du carnet de notes et l'importation de listes pour un certain nombre de systèmes d'information sur la scolarité (SIS) conformes à OneRoster. Google s'associe à des plates-formes SIS qui répondent aux exigences OneRoster spécifiées par Google.
Le partenariat avec Classroom permet aux administrateurs de connecter leurs cours Classroom à votre SIS.
Figure 1. Lorsque les systèmes d'information sur la scolarité (SIS) s'associent à Classroom, les administrateurs peuvent choisir le SIS dans le menu déroulant.
Parcours de développement des partenaires SIS
Si vous souhaitez devenir partenaire de Classroom, remplissez le formulaire d'intérêt.
L'équipe Classroom a créé un ensemble de tests de conformité que les partenaires SIS intéressés peuvent utiliser pour se familiariser avec les exigences de Google. Vous pouvez exécuter les tests de conformité avant de contacter l'équipe Classroom pour déterminer dans quelle mesure votre produit répond aux exigences de Google.
Obtenir un domaine de démonstration pour les développeurs
Vous pouvez demander l'accès à une instance Google Classroom en direct pour créer et valider une intégration. Les utilisateurs de test éligibles doivent disposer de l' édition Plus de Google Workspace for Education. Si vous ne disposez pas d'un accès administrateur à un domaine Google Workspace for Education avec ces licences, suivez les étapes pour obtenir un domaine de test pour les développeurs et demander une mise à niveau du domaine de démonstration. Votre domaine sera provisionné avec 10 licences Google Workspace for Education Plus.
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 OneRoster se terminant par
/ims/oneroster/v1p2 - 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. Cela vous aide à générer les résultats des tests à partager avec l'équipe Google Classroom.
Exigences et comportement attendu du SIS
Les tests définis par Google permettent aux partenaires SIS intéressés de déterminer si leur produit répond aux exigences de consommation OneRoster de Google et de minimiser les erreurs que les utilisateurs peuvent rencontrer lorsqu'ils utilisent des intégrations SIS dans Classroom. Lisez les pointeurs suivants sur les tests. Dans GitHub, chaque test comporte un titre référencé dans les pointeurs. N'oubliez pas que les pointeurs peuvent vous aider à clarifier vos questions, mais qu'il ne s'agit pas d'une liste exhaustive des tests. Assurez-vous d'avoir exécuté tous les tests fournis dans GitHub.
| 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 est utilisé pour s'assurer que votre produit peut prendre en charge 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. Cela utilisera l'adresse e-mail de l'enseignant que vous avez fournie dans la section "Credentials" (Identifiants) des tests. |
| Cours : 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 cours actifs. |
| É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. Ce term_sourced_id est utilisé pour récupérer les périodes de notation du trimestre en appelant le point de terminaison GET terms/{term_sourced_id}/gradingPeriods. |
| LineItem : Créer | Les périodes de notation ne sont pas obligatoires lorsque vous appelez PUT /lineItems/{line_item_sourced_id}. |
| LineItem : Modifier | L'appel d'API ne doit pas renvoyer d'erreur si la longueur du titre d'un devoir est longue. Le test inclut un titre de devoir de plus de 100 caractères. |
| Résultat : Modifier | Il devrait être possible de définir le score sur une valeur supérieure à resultValueMax pour représenter des points bonus. |
| Résultat : Supprimer | Le point de terminaison DELETE /results/{result_sourced_id} est obligatoire. |
| LineItem (facultatif / nettoyage) : Supprimer et obtenir | 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 teste que l'élément de ligne 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 OneRoster 1.2 de Google. Téléchargez le rapport généré ou prenez une capture d'écran pour le partager avec vos contacts de l'équipe Google Classroom.