Cette page répertorie certains malentendus et cas limites courants à prendre en compte lors de la conception et de la mise en œuvre de votre module complémentaire Classroom. Nous vous encourageons à mettre en œuvre des dispositifs de sécurité et des tests qui couvrent ces cas.
Concepts Google Classroom
Cette section présente les cas limites et les 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é de 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 de l'établissement peut être enseignant d'un cours, et que ses membres peuvent être des élèves de cours. Bien que le cas le plus courant soit pour 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 dans Google Classroom.
À propos des enseignants des cours:
- Un cours peut être associé à plusieurs enseignants.
- Des enseignants peuvent être ajoutés à un cours à tout moment.
- Les enseignants peuvent être exclus d'un cours à tout moment.
Élément de flux
Les éléments de flux correspondent aux 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.
Les enseignants créent des annonces en haut de la page "Flux" dans l'interface utilisateur de Classroom. Les enseignants créent des devoirs et des supports en cliquant sur le bouton Créer de l'onglet "Travaux et devoirs". Les développeurs peuvent les créer de manière automatisée via l'API Classroom.
Un devoir est un élément de flux permettant d'accepter le devoir d'un élève. Les devoirs sont le seul type d'élément de flux qui apparaît dans le carnet de notes et qui peut contenir une pièce jointe de module complémentaire.
À propos des é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 la notation d'un devoir à tout moment.
- Un devoir peut comporter plusieurs pièces jointes.
- Un devoir peut être associé à différents types de pièces jointes. Par exemple, un devoir peut contenir simultanément des documents Google Docs, des vidéos YouTube et des pièces jointes de modules complémentaires.
- Un devoir peut comporter des pièces jointes de module complémentaire provenant de plusieurs développeurs.
- Les développeurs peuvent obtenir et modifier des informations sur n'importe quel élément de flux associé à l'un de leurs modules complémentaires joints.
- Les développeurs peuvent rendre, récupérer ou rendre le devoir d'un élève pour un devoir qui inclut l'une de leurs pièces jointes de module complémentaire.
- Les développeurs ne peuvent attribuer une note qu'à des devoirs individuels dans les devoirs qu'ils ont créés.
É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.
Établissement de l'utilisateur
L'API Google Classroom ne renvoie pas les identifiants de l'établissement, du bâtiment ou de toute autre adhésion supérieure au niveau du cours d'un utilisateur.