Stratégie de mise en œuvre

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 type courseWork 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 ou announcements.GetAddOnContextRequest en fonction de la itemType 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 valeur submissionIds 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.