Stratégie de mise en œuvre

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 type courseWork 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 ou announcements.GetAddOnContextRequest en fonction des itemType à 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 ; la submissionIds 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.