Intégration de CourseWork

Les développeurs peuvent utiliser l'API Google Classroom pour interagir avec les devoirs dans Google Classroom. Une application qui utilise l'API de cette manière est appelée intégration CourseWork.

Important : Une intégration CourseWork permet aux développeurs d'accéder à l'état des annonces, des supports de cours, des devoirs et des devoirs rendus des élèves de Google Classroom, et de le modifier de manière programmatique. Choisissez cette option si vous avez besoin d'un moyen peu coûteux de transférer votre contenu dans Classroom.

Ce chemin d'intégration est couramment utilisé pour créer et noter des devoirs avec des liens vers des ressources en dehors de Classroom. Il offre aux développeurs un accès plus étendu à la gestion des cours que les boutons de partage Classroom.

Fonctionnement

La fonctionnalité principale d'une intégration CourseWork est la création et la gestion de devoirs, d'annonces et de supports de cours à l'aide de l'API Classroom.

Voici un exemple de parcours utilisateur courant rendu possible par une intégration CourseWork : permettre aux enseignants de découvrir, d'attribuer et de noter des contenus depuis votre site Web ou votre application :

1. Un enseignant se connecte à votre site Web.
2. L'enseignant trouve ou crée un contenu qu'il souhaite partager avec sa classe. L'enseignant clique sur un bouton de votre site Web pour envoyer ce contenu à Google Classroom.
3. Votre application envoie une requête à courses.courseWork.create. La requête contient un objet CourseWork dans son corps, qui contient les éléments suivants :
   • ID du cours de destination.
   • Titre du devoir.
   • Description textuelle du devoir.
   • link Material avec l'URL du contenu sélectionné par l'enseignant.
   • Le cas échéant, le score maximal pouvant être obtenu pour le contenu sélectionné.
4. Un devoir s'affiche dans Classroom avec un lien en pièce jointe. Le lien renvoie à l'URL spécifiée dans la requête create. Pour consulter un exemple, voir la figure 1.
5. Une nouvelle colonne pour le devoir apparaît également dans le carnet de notes Classroom, y compris le score maximal si celui-ci est fourni.
6. Les élèves reçoivent le devoir et cliquent sur link Material pour ouvrir l'URL fournie dans un nouvel onglet et afficher ou effectuer le contenu sur votre site Web. Vous pouvez également fournir des commandes permettant à l'élève de rendre le devoir.
7. Vous pouvez également envoyer une requête à courses.courseWork.studentSubmissions.modifyAttachments pour ajouter des pièces jointes à un devoir remis par un élève, comme un fichier Google Drive ou link Material qui pointe vers le travail de l'élève sur votre site Web.
8. Vous pouvez également envoyer une requête à courses.courseWork.studentSubmissions.patch pour définir la note de l'élève pour le devoir.

Figure 1. Vue de l'enseignant lors de la modification d'un devoir avec link Material créé par une intégration CourseWork.

Vous pouvez également appeler courses.announcements.create ou courses.courseWorkMaterials.create pour créer une annonce ou un support de cours au lieu d'un devoir. Pour obtenir des descriptions détaillées des actions de l'API Classroom concernées, consultez les pages Créer et gérer des devoirs et Définir et modifier des notes.

Remarques

Important : L'intégration de CourseWork présente des limites importantes. Si ces limites vous empêchent de réaliser votre produit, envisagez plutôt de créer un module complémentaire Google Classroom.

Avant de décider si une intégration CourseWork est le bon choix pour vos besoins en termes de produits, tenez compte des points suivants.

• Vous devez autoriser l'utilisateur et lui demander son consentement. Vous effectuez des requêtes d'API au nom de l'utilisateur. Cela signifie, par exemple, que vous ne pouvez pas créer de devoirs dans n'importe quel cours Google Classroom. Vous ne pouvez créer des devoirs que dans les cours que l'utilisateur autorisé enseigne.
• Vous avez besoin d'un moyen pour l'utilisateur de sélectionner un cours afin de recevoir le contenu. Envisagez d'utiliser courses.list pour obtenir la liste des cours dispensés par l'utilisateur, puis autorisez-le à sélectionner un ou plusieurs cours dans la liste.
• Lorsqu'un utilisateur clique sur un link Material dans Classroom, le lien s'ouvre dans un nouvel onglet. Votre serveur ne recevra aucune information de Classroom lorsque l'URL s'ouvrira.
• Un enseignant peut modifier ou supprimer le devoir indépendamment du développeur. Cela signifie que les connaissances d'un développeur sur le cours peuvent devenir obsolètes. Si vous avez besoin d'être informé des modifications apportées aux devoirs, pensez à configurer des notifications push pour les modifications apportées aux devoirs.
• Un enseignant peut créer des devoirs dans l'interface utilisateur Classroom en collant des liens vers des URL sur votre site Web. Les devoirs créés de cette manière appartiennent exclusivement à l'enseignant. Vous ne pourrez donc pas les consulter ni les modifier, ni définir de notes pour les devoirs rendus à l'aide de l'API Classroom.