Cette page présente brièvement les principales interactions entre votre application Web complémentaire et l'API des modules complémentaires Google Classroom.
iFrame de détection des pièces jointes
L'iFrame Discovery de pièces jointes est la page de destination des enseignants dans votre module complémentaire. Nous vous conseillons de prendre les mesures suivantes concernant cette vue:
- Lorsque l'iFrame de découverte des pièces jointes s'ouvre, créez un élément
courseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
ouannouncements.GetAddOnContextRequest
en fonction de laitemType
pour valider le rôle utilisateur et obtenir la valeursupportsStudentWork
. - Affichez l'interface utilisateur de création ou de découverte de contenus. Vous pouvez omettre les rattachements de type d'activité en fonction de la valeur de
supportsStudentWork
dans la réponse de validation du lancement. - En fonction des choix des enseignants, effectuez une ou plusieurs requêtes
create
de module complémentaire pour ajouter des pièces jointes au devoir.
Autres iFrames
L'iFrame Vue des élèves, l'iFrame "Examen des devoirs des élèves" et l'iFrame Vue des enseignants sont destinés à présenter du contenu à l'utilisateur plutôt qu'à 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.
- Si l'utilisateur actuel est un élève, associez le
submissionId
de la réponse au devoir de l'élève. Cette opération est nécessaire pour transmettre les notes et pour montrer aux enseignants les devoirs des élèves dans l'outil de notation. LessubmissionIds
correspondent entre les vues. - Si le module complémentaire connaît déjà
attachmentId
, affichez l'interface utilisateur de la pièce jointe appropriée. - Sinon, le post parent de cette 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 et copiez les paramètres afin de créer un modèle correspondant de la pièce jointe du côté du module complémentaire. Affichez ensuite l'interface utilisateur appropriée pour les pièces jointes.
- Si l'utilisateur actuel est un élève, associez le