Les pièces jointes sont les éléments de contenu que les utilisateurs consultent et avec lesquels ils interagissent. Ce guide présente brièvement les pièces jointes dans Google Classroom et définit une terminologie importante liée aux pièces jointes.
De manière très générale, le rôle d'un module complémentaire consiste à créer et à gérer des pièces jointes. Les modules complémentaires permettent aux élèves d'accéder à vos contenus directement dans Google Classroom. Contrairement aux devoirs créés à l'aide de l'API CourseeWork, les pièces jointes aux modules complémentaires vous permettent d'offrir des expériences personnalisées et interactives sans que l'utilisateur ait à quitter Google Classroom.
Les enseignants ajoutent des pièces jointes aux devoirs. Un devoir peut contenir jusqu'à 10 pièces jointes, mais seulement huit d'un même type. (vidéos YouTube, documents Google Docs ou liens externes, par exemple). Vous pouvez également joindre des fichiers à partir de Google Drive ou importés depuis votre ordinateur.
Figure 1. Les pièces jointes apparaissent sous forme de cartes lors de la création, l'affichage ou la réalisation d'un devoir.
Types de pièces jointes
Il existe deux types de pièces jointes de modules complémentaires: activity et content. Les pièces jointes par type d'activité sont celles qui nécessitent l'envoi d'un élève ou une action de leur part, comme un questionnaire ou une réponse écrite. Les pièces jointes par type de contenu sont des supports en lecture seule qui ne nécessitent pas l'envoi d'un élève, comme des vidéos ou des articles d'actualité.
Les interactions d'API liées aux pièces jointes diffèrent légèrement selon leur type. Pour en savoir plus sur les interactions avec les pièces jointes via l'API des modules complémentaires, consultez la page Interagir avec les pièces jointes du guide.
Pièces jointes notées automatiquement
Vous pouvez transmettre les notes à Google Classroom pour les pièces jointes de type activité. Le champ de notation d'un devoir spécifique est alors rempli avec une note temporaire. La note peut être n'importe quel nombre décimal ou supérieur. Consultez la page Interagir avec les pièces jointes pour en savoir plus sur l'implémentation.
Notez que cette fonctionnalité est très demandée par les enseignants. D'après nos recherches sur l'expérience utilisateur, de nombreux enseignants supposent que les notes des activités complémentaires sont automatiquement renvoyées dans Google Classroom.
Créer des pièces jointes à partir d'un site tiers
Vous pouvez créer des pièces jointes de modules complémentaires par programmation en dehors de Google Classroom. Les interactions sont semblables à la création de devoirs à l'aide des points de terminaison de l'API CourseWork. Consultez le guide dédié Créer des pièces jointes en dehors de Google Classroom pour en savoir plus sur l'implémentation.