Google Classroom permet d'importer des listes d'élèves et de synchroniser les carnets de notes pour un certain nombre de systèmes d'information sur la scolarité (SIS) compatibles avec OneRoster. Google s'associe à des plates-formes SIS qui répondent aux exigences OneRoster spécifiées par Google.
Figure 1. Lorsque les systèmes d'information sur la scolarité (SIS) s'associent à Classroom, les administrateurs peuvent sélectionner le SIS dans le menu déroulant.
Parcours d'intégration des partenaires SIS
Voici un aperçu du parcours d'intégration des partenaires SIS :
Manifester votre intérêt : si vous souhaitez devenir partenaire de Classroom, remplissez le formulaire de participation.
Explorer et exécuter les tests de conformité : pour savoir si votre SIS est prêt à s'intégrer à Classroom, vous pouvez consulter les tests de conformité afin de vous familiariser avec les exigences de Google. Vous pouvez exécuter les tests de conformité avant d'exprimer votre intérêt auprès de l'équipe Google Classroom afin de déterminer dans quelle mesure votre produit répond aux exigences de Google.
Contacter l'équipe Google Classroom : L'équipe Classroom vous contactera après l'envoi de votre formulaire de participation si une opportunité de partenariat se présente.
Partagez les résultats de vos tests et créez l'intégration de bout en bout : une fois que l'équipe Classroom vous a contacté, partagez les résultats de vos tests de conformité. Votre équipe collaborera avec Google pour valider et finaliser l'intégration.
Tests de conformité
Les tests de conformité définis par Google permettent aux partenaires SIS de déterminer si leur produit répond aux exigences de consommation OneRoster de Google et de minimiser les erreurs que les utilisateurs pourraient rencontrer lors de l'utilisation des intégrations SIS dans Classroom. Les tests sont publiés sur GitHub.
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. Les notebooks Colab et 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
Lisez les conseils suivants sur les tests. Dans GitHub, chaque test est associé à un titre référencé dans le tableau. Ces conseils peuvent vous aider à clarifier les questions, mais il ne s'agit pas d'une liste exhaustive des tests. Assurez-vous d'avoir exécuté tous les tests fournis dans GitHub pour garantir la conformité.
| Test | Pointeurs |
|---|---|
| Teachers: 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 accepter une taille de page de 10 000. |
| Teachers: 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 fournie 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. |
| Students: 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 compatibilité avec les périodes de notation est testée à l'aide de term_sourced_id. Ce term_sourced_id permet de récupérer les périodes de notation du trimestre en appelant le point de terminaison GET /terms/{term_sourced_id}/gradingPeriods. |
| LineItem: Create | Les périodes de notation ne sont pas obligatoires lors de l'appel de PUT /lineItems/{line_item_sourced_id}. |
| Élément de campagne : modifier | L'appel d'API ne doit pas renvoyer d'erreur si un titre de devoir long est inclus. Le test inclut un titre de devoir de plus de 100 caractères. |
| Résultat : Modifier | Il doit être possible de définir une valeur score supérieure à la valeur resultValueMax pour représenter des points supplémentaires. |
| Résultat : Supprimer | Veuillez indiquer le point de terminaison DELETE /results/{result_sourced_id}. |
| LineItem (facultatif/nettoyage) : Delete et Get | 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 la suppression de l'élément de campagne. |
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é. Les résultats sont utilisés pour déterminer si votre produit répond aux exigences de consommation OneRoster 1.2 de Google. Téléchargez ou prenez une capture d'écran du rapport généré pour le partager avec vos contacts de l'équipe Google Classroom.
Obtenir un domaine de démonstration pour les développeurs
Une fois que l'équipe Google Classroom a examiné les résultats de vos tests de conformité, un domaine de démonstration pour les développeurs vous permet de valider votre intégration de bout en bout. N'oubliez pas que la réussite des tests de conformité ne garantit pas l'approbation du partenariat ou de l'intégration.
Un domaine de démonstration pour les développeurs est un environnement de test Google Classroom en ligne qui vous aide à vérifier que votre intégration fonctionne comme prévu. Suivez la procédure pour obtenir un domaine de démonstration pour les développeurs et demander une mise à niveau du domaine de démonstration. La mise à niveau provisionne votre domaine avec 10 licences Google Workspace for Education Plus. Ces licences doivent être attribuées à des utilisateurs de test dans votre domaine de développeur afin qu'ils puissent tester les fonctionnalités d'intégration du SIS dans Classroom.
Questions fréquentes
1. Quel modèle de données Classroom attend-il du SIS ?
Classroom respecte la spécification OneRoster 1.2. Si votre SIS utilise une structure de données différente, vous risquez de rencontrer un comportement inattendu. Par exemple, si votre système accepte une relation imbriquée entre les périodes de notation et les catégories de notes, cela ne relève pas de la spécification OneRoster 1.2. Vous devez donc tester minutieusement votre intégration pour vous assurer de sa compatibilité.
2. Quels sont les notes et les états des devoirs exportés vers le SIS ?
Seules les notes remises ou les devoirs marqués comme "manquants" ou "excusés" sont exportés vers le SIS. Les notes temporaires ne sont pas exportées.
3. Que se passe-t-il pour l'élément de campagne dans le SIS si un devoir est supprimé dans Classroom ?
La suppression d'un devoir dans Classroom ne supprime pas l'élément de campagne correspondant dans le SIS. Cela évite la perte accidentelle de données et les suppressions en cascade involontaires.