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 les 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 permettent de proposer 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 comporter jusqu'à dix pièces jointes, mais seulement huit d'un même type. Les pièces jointes peuvent être des vidéos YouTube, des documents Google Docs ou des liens externes, par exemple. Vous pouvez également joindre des fichiers depuis 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 que l'élève envoie ou remette un devoir, 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 avec l'API liées aux pièces jointes diffèrent légèrement selon le 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 transférer les notes vers Google Classroom pour les pièces jointes de type activité. Cela permet de remplir le champ "Note" d'un devoir spécifique avec une note provisoire. La note peut être n'importe quel nombre décimal supérieur ou égal à zéro. Pour en savoir plus sur l'implémentation, consultez la page du guide Interagir avec les pièces jointes.
Notez que cette fonctionnalité est très demandée par les enseignants. Nos études sur l'expérience utilisateur ont montré que de nombreux enseignants supposent que les notes des activités de modules complémentaires sont automatiquement renvoyées à 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 semblables à 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.