Stratégie de mise en œuvre

Cette page présente brièvement les interactions clés entre votre application Web de module complémentaire et l'API des modules complémentaires Google Classroom.

IFrame de découverte des pièces jointes

L'iFrame de découverte des pièces jointes est la page de destination des enseignants dans votre module complémentaire. Vous pouvez effectuer les actions suivantes concernant cette vue:

  • Affichez l'interface utilisateur de votre outil de découverte ou de création de contenu.

    Vous pouvez également déterminer si l'élément du flux acceptera les réponses des élèves, car vous pouvez empêcher l'enseignant d'ajouter des pièces jointes de type activité. Vérifiez la valeur du paramètre de requête itemType qui a été transmise 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 sélections de l'enseignant, envoyez une ou plusieurs requêtes create de module complémentaire pour ajouter des pièces jointes au devoir.

Autres iFrames

L'iFrame de la vue de l'élève, l'iFrame d'évaluation du travail des élèves et l'iFrame de la vue de l'enseignant sont tous 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'une iFrame s'ouvre, obtenez le consentement OAuth de l'utilisateur, puis validez son rôle et son ID d'attachement.
  • Lorsqu'un iframe s'ouvre, créez un courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest ou announcements.GetAddOnContextRequest basé sur itemType pour valider le rôle utilisateur.
  • Si l'utilisateur actuel est un élève, associez le submissionId de la réponse au travail de l'élève. Cela est nécessaire pour renvoyer les notes et pour afficher le travail des élèves aux enseignants dans l'outil de notation. Les submissionIds correspondent dans toutes les vues.
  • Si le attachmentId est déjà connu du module complémentaire, affichez l'UI d'attachement appropriée.
  • Sinon, il est possible que le post parent de cette pièce jointe ait été copié à partir d'un autre post ou cours. Utilisez copyHistory pour identifier la copie la plus récente que le module complémentaire connaît et copiez-en les paramètres pour créer un nouveau modèle correspondant de la pièce jointe du côté du module complémentaire. Affichez ensuite l'UI d'attachement appropriée.