Google Classroom est compatible avec la synchronisation du carnet de notes et l'importation de listes d'élèves pour un certain nombre de systèmes d'information sur la scolarité (SIS) conformes à OneRoster. Google collabore avec des plates-formes SIS qui répondent aux exigences OneRoster spécifiées par Google.
Le partenariat avec Classroom permet aux administrateurs d'associer leurs cours Classroom à votre SIS.
Figure 1. Lorsque des systèmes d'information sur la scolarité (SIS) sont associés à 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 de demande de participation.
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 tests éligibles doivent disposer de l'édition Plus de Google Workspace for Education. Si vous n'avez pas accès en tant qu'administrateur à un domaine Google Workspace for Education avec ces licences, suivez la procédure pour obtenir un domaine de test pour les développeurs et demander la mise à niveau d'un domaine de démonstration. 10 licences Google Workspace for Education Plus seront provisionnées pour votre domaine.
Accéder aux tests et les exécuter
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
- URL OneRoster 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 les notebooks Jupyter vous permettent d'exécuter tous les tests à la fois. 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 les intégrations SIS dans Classroom. Lisez les conseils suivants sur les tests. Dans GitHub, chaque test possède un titre référencé dans les pointeurs. N'oubliez pas que les conseils peuvent vous 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 |
|---|---|
| Teachers: GetAllTeachers | Le point de terminaison GET /teachers est appelé avec un paramètre de requête limit. Lors des 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. 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 figurer dans la réponse. |
| GetGradingPeriodsForTerm | La compatibilité des 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 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 trop longue. Le test inclut un titre de devoir de plus de 100 caractères. |
| Résultat : Modifier | Il devrait être possible de définir score sur une valeur supérieure à resultValueMax pour représenter un crédit supplémentaire. |
| 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. Elle est facultative et sert à nettoyer les données. Le point de terminaison GET /classes/{class_sourced_id}/lineItems suivant est également facultatif et permet de vérifier 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 Google concernant la consommation OneRoster 1.2. Téléchargez le rapport généré ou prenez-en une capture d'écran pour le partager avec l'équipe Google Classroom.
Obtenir de l'aide
Si vous avez des questions, envoyez un e-mail à classroom-sis-external@google.com.