Stratégie de mise en œuvre

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 ou announcements.GetAddOnContextRequest en fonction de la itemType pour valider le rôle utilisateur et obtenir la valeur supportsStudentWork.
  • 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. Les submissionIds 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.