Cette page liste certains malentendus courants et cas particuliers que vous pouvez prendre en compte lors de la conception et de l'implémentation de votre module complémentaire Classroom. Nous vous encourageons à implémenter des systèmes de secours et des tests qui couvrent ces cas.
Concepts Google Classroom
Cette section met en avant des cas particuliers et des concepts pertinents pour les modules complémentaires qui s'appliquent à l'ensemble de Google Classroom.
Cours et rôles utilisateur
Un cours est l'unité organisationnelle centrale qui met en relation les enseignants et les élèves. Les cours constituent le niveau d'organisation le plus élevé dans l'API Google Classroom.
Les utilisateurs individuels peuvent être ajoutés à un cours en tant qu'"enseignants" ou "élèves". Le rôle d'un utilisateur dans le cours n'est pas lié à son rôle dans l'établissement. Cela signifie qu'un élève membre de l'école peut être enseignant dans un cours, et que les enseignants membres peuvent être élèves dans des cours. Bien que le cas le plus courant concerne un cours qui représente un sujet universitaire régulièrement programmé, des cours sont également créés pour organiser des clubs d'étudiants ou effectuer un développement professionnel.
Les informations suivantes s'appliquent à tous les cours de Google Classroom.
Concernant les enseignants de cours:
- Un cours peut être associé à plusieurs enseignants.
- Vous pouvez ajouter des enseignants à un cours à tout moment.
- Les enseignants peuvent être retirés d'un cours à tout moment.
Élément de flux
Les éléments de flux sont les contenus publiés partagés avec les membres d'un cours. Les développeurs et les enseignants peuvent créer des pièces jointes de modules complémentaires pour trois types d'éléments de flux: les annonces, les devoirs et les supports de cours.
Les enseignants créent des annonces en haut de la page "Flux" dans l'interface utilisateur de Classroom. Pour créer des devoirs et des supports, les enseignants doivent cliquer sur le bouton Créer dans l'onglet "Devoirs et travaux". Les développeurs peuvent les créer de manière automatisée via l'API Classroom.
Un devoir est un élément de flux pouvant accepter un devoir d'élève. Les devoirs sont le seul type d'élément de flux qui apparaît dans le cahier de notes et qui peut contenir une pièce jointe de module complémentaire.
Concernant les éléments de flux:
- Un devoir ou un support peut être attribué à un sous-ensemble d'élèves du cours.
- Un devoir peut être noté ou non. Les enseignants peuvent modifier l'état de notation d'un devoir à tout moment.
- Un devoir peut comporter plusieurs pièces jointes.
- Une devoir peut comporter des pièces jointes de différents types. Par exemple, un devoir peut comporter simultanément des pièces jointes Google Docs, des vidéos YouTube et des modules complémentaires.
- Une devoir peut comporter des pièces jointes de plusieurs développeurs.
- Les développeurs peuvent obtenir et modifier des informations sur n'importe quel élément de flux à l'aide de l'une de leurs pièces jointes de module complémentaire.
- Les développeurs peuvent rendre, récupérer ou renvoyer le travail d'un élève pour un devoir qui inclut l'un de leurs fichiers joints de module complémentaire.
- Les développeurs ne peuvent définir des notes que pour les devoirs qu'ils ont créés et pour les devoirs envoyés par des élèves individuels.
Éléments de flux copiés
Les enseignants peuvent copier un élément de flux en copiant un cours, en réutilisant un devoir ou en publiant un élément de flux dans plusieurs cours. Consultez notre guide sur le contenu copié pour comprendre comment le module complémentaire peut gérer ces scénarios.
Institution de l'utilisateur
L'API Google Classroom ne renvoie pas d'identifiants pour l'établissement, le bâtiment ou toute autre appartenance d'un utilisateur au-delà du niveau du cours.