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 certains termes importants liés aux pièces jointes.
De manière générale, le rôle d'un module complémentaire est de créer et de 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 CourseWork, les pièces jointes de modules complémentaires sont compatibles avec vos expériences personnalisées et interactives sans que l'utilisateur ait à quitter Google Classroom.
Les enseignants ajoutent des pièces jointes aux devoirs. Une devoir peut comporter jusqu'à dix pièces jointes, mais seulement huit de chaque type. Les vidéos YouTube, les documents Google Docs ou les liens externes sont des exemples de pièces jointes. Vous pouvez également joindre des fichiers stockés dans Google Drive ou importés depuis votre ordinateur.
Figure 1. Les pièces jointes s'affichent sous forme de fiches lorsque vous créez, consultez ou terminez un devoir.
Types de pièces jointes
Il existe deux types de pièces jointes de modules complémentaires: activité et contenu. Les pièces jointes de type "Activité" sont celles qui nécessitent une action de la part de l'élève, comme un questionnaire ou une réponse écrite. Les pièces jointes de type "Contenu" sont des documents en lecture seule qui ne nécessitent pas de devoir de la part des élèves, comme des vidéos ou des articles d'actualité.
Les interactions de l'API liées aux pièces jointes diffèrent légèrement en fonction du type de pièce jointe. Pour en savoir plus sur les interactions avec les pièces jointes via l'API des modules complémentaires, consultez la page du guide Interagir avec les pièces jointes.
Pièces jointes notées automatiquement
Vous pouvez transmettre les notes à Google Classroom pour les pièces jointes de type activité. Le champ de note d'un devoir particulier est alors renseigné avec une note provisoire. La note peut être un nombre décimal supérieur ou égal à zéro. Pour en savoir plus sur l'implémentation, consultez le guide Interagir avec les pièces jointes.
Notez que c'est une fonctionnalité très demandée par les enseignants. Nos recherches sur l'expérience utilisateur ont montré que de nombreux enseignants supposent que les notes des activités des modules 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 de manière programmatique en dehors de Google Classroom. Les interactions sont similaires à la création de devoirs à l'aide des points de terminaison de l'API CourseWork. Pour en savoir plus sur l'implémentation, consultez le guide dédié Créer des pièces jointes en dehors de Google Classroom.