Cette page présente brièvement les principales interactions entre votre application Web de module complémentaire et l'API des modules complémentaires Google Classroom.
iFrame de découverte de pièces jointes
L'iFrame de découverte des pièces jointes est la page de destination pour les enseignants de votre module complémentaire. Nous vous conseillons d'effectuer les actions suivantes concernant cette vue:
afficher votre interface de découverte ou de création de contenu ;
Vous pouvez également déterminer si l'élément de flux acceptera les réponses des élèves, afin d'empêcher l'enseignant d'ajouter des pièces jointes liées au type d'activité. Vérifiez la valeur du paramètre de requête
itemType
transmis lors de l'ouverture de l'iFrame du module complémentaire. Seul le typecourseWork
accepte les réponses des élèves.En fonction des choix de l'enseignant, effectuez une ou plusieurs requêtes
create
de modules complémentaires pour ajouter des pièces jointes au devoir.
Autres iFrames
Les cadres iFrame Vue élève, Examen des devoirs des élèves et iFrame Vue des enseignants sont tous destinés à présenter du contenu à l'utilisateur plutôt que de modifier un devoir Classroom. Envisagez de prendre les mesures suivantes concernant ces vues:
- Lorsqu'un iFrame s'ouvre, obtenez l'autorisation OAuth de l'utilisateur, puis validez son rôle et son ID de pièce jointe.
- Lorsqu'un iFrame s'ouvre, créez un élément
courseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
ouannouncements.GetAddOnContextRequest
en fonction de laitemType
pour valider le rôle utilisateur. - Si l'utilisateur actuel est un élève, associez la valeur
submissionId
de la réponse au devoir de l'élève. Cela est nécessaire pour transmettre les notes et pour montrer aux enseignants les devoirs des élèves dans l'outil de notation. La valeursubmissionIds
correspond à toutes les vues. - Si le module complémentaire
attachmentId
connaît déjà le module complémentaire, affichez l'interface utilisateur de pièce jointe appropriée. - Sinon, le post parent de la pièce jointe doit avoir été copié à partir d'un autre post ou cours. Utilisez
copyHistory
pour identifier la copie la plus récente dont le module complémentaire a connaissance, puis copiez les paramètres de celle-ci pour créer un modèle correspondant de la pièce jointe du côté du module complémentaire. Affichez ensuite l'interface utilisateur de pièce jointe appropriée.