Cette page offre un bref aperçu des principales interactions entre votre module complémentaire sur le Web 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 un 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 ;
Si vous le souhaitez, déterminez si l'élément de flux acceptera les réponses des élèves, car vous voulez peut-être empêcher l'enseignant d'ajouter des activités et les pièces jointes. Vérifiez la valeur du paramètre de requête
itemType
qui a été transmis lorsque l'iFrame du module complémentaire est ouvert. Seul le typecourseWork
accepte réponses des élèves.En fonction des choix de l'enseignant, envoyez une ou plusieurs demandes de modules complémentaires à
create
pour ajouter des pièces jointes au devoir.
Autres iFrames
Les cadres iFrame "Vue des élèves", iFrame d'examen des devoirs des élèves et Vue des enseignants Les iFrame sont tous destinés à présenter du contenu à l'utilisateur plutôt que de modifier un Devoir Classroom. Envisagez d'effectuer les actions suivantes concernant ces vues:
- Lorsqu'un iFrame s'ouvre, obtenez l'autorisation OAuth de l'utilisateur, puis validez ses le rôle et l'ID de la pièce jointe.
- Lorsqu'un iFrame s'ouvre, créez un élément
courseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
ouannouncements.GetAddOnContextRequest
en fonction desitemType
à valider un rôle utilisateur spécifique. - Si l'utilisateur actuel est un élève, associez
submissionId
à partir de avec le travail des élèves. Ceci est nécessaire pour renvoyer des notes et pour montrer aux enseignants les devoirs des élèves dans l'outil de notation ; lasubmissionIds
correspondance entre les vues. - Si le module complémentaire connaît déjà
attachmentId
, affichez l'élément approprié des pièces jointes. - Dans le cas contraire, le post parent de cette pièce jointe doit être
copiées à partir d'un autre post ou d'un autre cours. Utilisez
copyHistory
pour identifier les une copie récente dont le module complémentaire a connaissance, puis copiez les paramètres de celle-ci dans créer un modèle correspondant à la pièce jointe du côté du module complémentaire. Ensuite, afficher l'UI appropriée pour la pièce jointe.