Conditions requises pour les modules complémentaires

Version 1.0, 30 avril 2024.

Les critères de cette page s'appliquent à tous les modules complémentaires Classroom. Votre un module complémentaire doit répondre à tous les critères requis pour pouvoir figurer dans Google Workspace Marketplace et un module complémentaire Classroom".

Les mots clés "OBLIGATOIRE", "NE DOIT PAS", "OBLIGATOIRE", "DEVRAIT", "NE DOIT PAS", "DEVRAIT", "NE DEVRAIT PAS", "RECOMMANDÉ", "PEUT" et "FACULTATIF" de ce document doivent être interprété conformément à la norme RFC 2119.

Conditions requises

ID Type
1.0 Licence de l'utilisateur final (le cas échéant)
  1.1 Un message convivial DOIT être présenté à l'utilisateur s'il ne possède pas de licence. Le message DOIT indiquer clairement la raison pour laquelle le module complémentaire ne peut pas être utilisé et suggérer à l'utilisateur un plan d'action pour remédier à la situation. REQUIRED
  1.3 La fiche Google Workspace Marketplace du module complémentaire DOIT indiquer les détails des conditions de licence qui peuvent être requises pour l'utiliser. Si le module complémentaire comporte un niveau payant, la fiche Marketplace DOIT fournir un lien vers une page Web fournissant plus d'informations sur les prix ou sur la manière de contacter un commercial. REQUIRED
2.0 Connexion de l'utilisateur final
  2.1 Les utilisateurs enseignants DOIVENT se connecter au module complémentaire à l'aide de l'authentification unique Google.
Si les élèves sont invités à se connecter au module complémentaire, ils DOIVENT se connecter avec l'authentification unique Google.
REQUIRED
  2.2 Le module complémentaire DOIT utiliser l'authentification unique Google pour connecter automatiquement un utilisateur lors des visites suivantes sans afficher d'invite de connexion.
Lorsque l'indice de connexion ne génère pas de correspondance avec l'utilisateur actuellement connecté, le module complémentaire DOIT inviter l'utilisateur à se connecter à l'aide d'un bouton de connexion et le transmettre à la bibliothèque d'authentification pour filtrer les comptes non valides.
REQUIRED
  2.7 Lorsque l'utilisateur Classroom n'est pas déjà connecté au module complémentaire (comme déterminé par l'indice de connexion), celui-ci DOIT présenter la mention "Se connecter avec Google". bouton permettant d'effectuer une action explicite de l'utilisateur afin de déclencher le processus de connexion.
Remarque: Cette étape est nécessaire pour respecter les consignes relatives à la marque Google et pour éviter les blocages des pop-up.
REQUIRED
  2,8 Le module complémentaire DOIT afficher le nom de l'utilisateur actuellement connecté. RECOMMANDÉ
3.0 Général
  3.1 Le module complémentaire DOIT respecter les Consignes d'approbation générales de Google Workspace Marketplace. REQUIRED
  3.2 Si une tâche est lancée dans un nouvel onglet ou une nouvelle fenêtre à partir de l'un des parcours iFrame, elle DOIT fournir un message convivial pour revenir dans Classroom. REQUIRED
  3.3 L'utilisateur DOIT suivre uniquement le parcours à l'aide d'un workflow de module complémentaire, et ne pas passer à un parcours CourseWork ni utiliser le bouton de partage de Classroom. REQUIRED
  3.4 Choix de la localisation: la langue DOIT être basée sur les préférences locales définies par le navigateur, le cas échéant. RECOMMANDÉ
  3.5 Si un module complémentaire définit maxPoints, il DOIT également définir pointsEarned lorsqu'un élève termine un devoir à l'aide des identifiants d'enseignant enregistrés (recommandé) OU lorsque l'enseignant ouvre le devoir dans l'iFrame de révision des devoirs des élèves. REQUIRED
  3.9 Les modules complémentaires DOIVENT être conformes aux directives AA de niveau AA des WCAG 2.1 en matière d'accessibilité. Les développeurs de modules complémentaires signaleront eux-mêmes que cette exigence est respectée au moment de l'envoi et que le module complémentaire continue d'être conforme aux futures modifications apportées. RECOMMANDÉ
  3,10 Toute erreur rencontrée par un utilisateur DOIT être lisible par l'humain. REQUIRED
  3.11 Si studentViewUri, teacherViewUri ou studentWorkViewUri est lancé à partir d'un devoir ou d'un cours copié, le module complémentaire NE DOIT PAS afficher de page d'erreur dans l'iFrame. REQUIRED
  3.12 Si studentViewUri, teacherViewUri ou studentWorkViewUri sont lancés à partir d'un devoir ou d'un cours copié, le module complémentaire DOIT afficher une nouvelle pièce jointe pour que l'élève puisse effectuer la tâche, et NE DEVRAIT PAS afficher dans l'iFrame les réponses d'un élève à ses devoirs ou cours précédents. RECOMMANDÉ
4.0 Découverte de pièces jointes
  4.1 Si une pièce jointe nécessite un envoi par un élève, elle DOIT inclure un élément studentWorkReviewUri pour être traitée comme une pièce jointe de type activité et non de type contenu. REQUIRED
  4.2 L'iFrame de découverte de pièces jointes DOIT fournir une interface utilisateur offrant au moins l'un des éléments suivants:
  • Créer un contenu à joindre
  • Parcourir, sélectionner et joindre des contenus à partir d'une bibliothèque de contenus
  • Instructions pour joindre des contenus de votre site Web ou d'autres produits
REQUIRED
  4.3 L'enseignant DOIT être en mesure de trouver et d'accéder à l'ensemble des contenus et activités proposés. RECOMMANDÉ
  4.4 L'enseignant DOIT pouvoir prévisualiser le contenu ou l'activité avant de s'engager à le joindre au devoir. REQUIRED
  4.5 Si l'enseignant doit travailler pour créer du contenu ou une activité avant de pouvoir le joindre, ce travail DOIT être effectué dans l'iFrame. RECOMMANDÉ
5.0 Vue élève
  5.1 Lors du lancement de studentViewUri, le module complémentaire NE DOIT PAS faire sortir l'utilisateur de l'iFrame pour terminer une tâche.
Si le module complémentaire le fait sortir de l'iFrame, il DOIT s'afficher un message ou toute autre indication invitant les élèves à revenir dans Classroom.
RECOMMANDÉ
  5.2 Si une activité de module complémentaire sort de l'iFrame, il DOIT y avoir un aperçu de la tâche dans l'iFrame. REQUIRED
  5,3 Si une activité nécessite qu'un élève effectue une action pour marquer le devoir comme terminé, le bouton NE DOIT PAS être intitulé "Rendre le devoir" pour éviter toute confusion avec le bouton de remise Classroom. REQUIRED
6,0 Vue enseignant
  6,1 L'enseignant DOIT être en mesure de voir ce que l'élève verra après avoir rendu son devoir. RECOMMANDÉ
7,0 Révision des devoirs des élèves
  7.1 Si studentWorkReviewUri est lancé, le module complémentaire DOIT rendre le travail de cet élève pour examen par l'enseignant dans l'iFrame. Les documents supplémentaires peuvent comporter des liens en dehors de l'iFrame. REQUIRED
  7.2 Le module complémentaire NE DOIT PAS activer la navigation entre les élèves dans la vue studentWorkReviewUri. La navigation entre les élèves DOIT avoir lieu uniquement dans l'interface utilisateur de Classroom. REQUIRED
8,0 Assistance mobile Classroom
  8.1 Lorsque l'application mobile Classroom lance une teacherViewUri, une studentViewUri ou une studentWorkReviewUri, l'URL DOIT ouvrir l'application mobile native ou l'application Web mobile du partenaire et, dans les deux cas, créer un lien profond vers la vue appropriée. Si l'appareil n'est pas compatible, un message DOIT être affiché pour informer l'utilisateur qu'il s'agit d'un appareil non compatible et, idéalement, indiquer les appareils compatibles. REQUIRED
  8.2 Les devoirs des élèves DOIVENT être effectués sur un appareil mobile. RECOMMANDÉ
9,0 Autres fonctionnalités
  9,1 Si les enseignants peuvent coller des liens vers votre contenu sous forme de pièces jointes, vous DEVEZ convertir les liens en pièces jointes de modules complémentaires. RECOMMANDÉ
  9.2 Si vous utilisez une intégration de CourseWork pour créer des devoirs en dehors de Classroom, vous DEVEZ créer des pièces jointes de module complémentaire par défaut pour tous les liens compatibles avec votre module complémentaire. RECOMMANDÉ

Journal des modifications

Version 1.0 Mise à jour : 30 avr. 2024
1.1 Combinaison des sections 1.1 et 1.2 en une seule exigence.
2.1 Combinaison des sections 2.1 et 2.5 en une seule condition.
2.2 Combinaison des sections 2.2, 2.3 et 2.4 en une seule exigence.
3.5 Combinaison des sections 3.5, 3.6 et 3.7 en une seule condition.
3,10 Ajout d'une exigence selon laquelle le module complémentaire n'entre jamais dans un irrécupérable.
3,11, 3,12 Mise en commun des versions 5.5, 5.6, 6.3, 6.4, 7.5 et 7.6 en exigences.
4.2 Description plus détaillée des expériences acceptables pour la découverte de pièces jointes.
4.3 Renuméroté, anciennement 4.2. Également modifié de REQUIRED en RECOMMANDÉ.
4.4 Renuméroté, anciennement 4.3.
4.5 Renuméroté, anciennement 4.4.
5.2 Renuméroté, anciennement 5.3.
5,3 Renuméroté, anciennement 5.2.
9,1 Ajout d'une recommandation pour mettre à jour les liens collés dans les pièces jointes.
9.2 Ajout d'une recommandation indiquant que les pièces jointes de modules complémentaires sont créées par défaut lorsque créer des devoirs CourseWork par programmation.
2,6, 3,7, 3,8, 6,2, 7,3 et 7,4 Supprimé.
Version 0.3 Mise à jour : 22 nov. 2022
2.3 Correction des indications de connexion.
2.4 Intégration d'un scénario dans lequel l'implémentation de hd est obligatoire.
3.2 Reformulation "fournit un chemin d'accès".
5,5, 5,6, 6,3, 6,4, 7,5 et 7,6 Ajout du texte du cours obligatoire et des conseils recommandés pour studentViewUri, teacherViewUri et studentWorkReviewUri
Version 0.2 Mise à jour : 29 oct. 2021
1.3 Modification du texte pour clarifier l'intention.
3.1 Ajout : "Le module complémentaire DOIT respecter les consignes générales d'approbation de GWM trouvé sur leur site Web. »
3.9 Le libellé "WCAG" est passé de "REQUIRED" à "RECOMMANDED" (OBLIGATOIRE).
5.1 Remplacement de REQUIRED par RECOMMENDED (RECOMMANDÉ).
5,3 Ajout du message "Si le module complémentaire sort de l'iFrame, il DOIT disposer d'un aperçu sur la tâche dans l'iFrame. »
5.4 Ajout du message "Si le module complémentaire sort de l'iFrame, une invite DOIT s'afficher pour que les élèves retournent dans Classroom."
8.1 Ajout : "Si l'appareil n'est pas compatible, un message DOIT être affiché au l'utilisateur pour lui faire savoir qu'il s'agit d'un appareil non pris en charge et, idéalement, sont pris en charge. »
8.2 Le devoir mobile des élèves, REQUIRED, a été remplacé par RECOMMENDED.
Version 0.1 Mise à jour : 22 septembre 2021
  Version initiale.