Conditions requises pour les modules complémentaires

Version 1.0, 30 avril 2024.

Les critères indiqués sur cette page s'appliquent à tous les modules complémentaires Classroom. Votre module complémentaire doit remplir tous les critères requis pour être approuvé pour une fiche dans Google Workspace Marketplace et disposer d'un module complémentaire "Compatible avec Classroom".

Les mots clés "DOIT", "DOIT PAS", "OBLIGATOIRE", "DOIT", "NE DOIT PAS", "NE DEVRAIT PAS", "NE DEVRAIT PAS", "RECOMMANDÉ", "PEUT" et "FACULTATIF" dans ce document doivent être interprétés comme décrit dans le document RFC 2119.

Conditions requises

ID Type
1.0 Licence d'utilisateur final (le cas échéant)
  1,1 Lorsqu'un utilisateur ne possède pas de licence, un message convivial DOIT s'afficher. Le message DOIT indiquer clairement la raison pour laquelle le module complémentaire ne peut pas être utilisé et suggérer à l'utilisateur une solution à ce problème. REQUIRED
  1,3 La fiche Google Workspace Marketplace du module complémentaire DOIT indiquer des détails sur les 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 tarifs ou sur la procédure à suivre pour contacter un commercial. REQUIRED
2.0 Connexion de l'utilisateur final
  2.1 Les 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 à l'aide de l'authentification unique Google.
REQUIRED
  2.2 Le module complémentaire DOIT utiliser l'authentification unique Google pour connecter automatiquement les utilisateurs lors de leurs prochaines visites, sans afficher d'invite de connexion.
Lorsque l'indice de connexion ne produit aucune correspondance avec l'utilisateur actuellement connecté, le module DOIT inviter l'utilisateur à se connecter et transmettre le paramètre login_hint à la bibliothèque d'authentification pour filtrer les comptes non valides.
REQUIRED
  2.7 Lorsque l'utilisateur Classroom n'est pas encore connecté au module complémentaire (comme déterminé en consultant l'indice de connexion), celui-ci DOIT présenter un bouton "Se connecter avec Google" pour déclencher le processus de connexion de façon explicite.
Remarque: Cette étape est nécessaire pour respecter les consignes relatives à la marque Google et pour éviter la fonctionnalité de blocage des pop-up.
REQUIRED
  2,8 Le module complémentaire DOIT afficher l'identité de l'utilisateur actuellement connecté. RECOMMANDÉE
3.0 Général
  3.1 Le module complémentaire DOIT respecter les consignes d'approbation générales pour 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 à Classroom. REQUIRED
  3,3 L'utilisateur DOIT terminer le parcours uniquement à l'aide d'un workflow complémentaire, et non passer à un flux courseWork ou utiliser le bouton de partage 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ÉE
  3,5 Si un module complémentaire définit maxPoints, il DOIT également définir pointsEarned lorsqu'un élève envoie un devoir à l'aide des identifiants de l'enseignant stocké (recommandé) OU lorsque l'enseignant ouvre le devoir dans l'iFrame "Examen des devoirs". REQUIRED
  3.9 Les modules complémentaires DOIVENT être conformes aux directives d'accessibilité des WCAG 2.1 niveau AA. Les développeurs des modules complémentaires indiqueront eux-mêmes que cette exigence est respectée au moment de l'envoi et que le module complémentaire reste conforme aux futures modifications. RECOMMANDÉE
  3,10 Toute erreur rencontrée par un utilisateur DOIT être lisible. REQUIRED
  3.11 Si studentViewUri, teacherViewUri ou studentWorkViewUri est lancé à partir d'un devoir copié 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 est lancé à partir d'un devoir copié ou d'un cours copié, le module complémentaire DOIT afficher une nouvelle pièce jointe que l'élève doit compléter et NE PAS afficher les réponses d'un élève à des devoirs ou cours précédents dans l'iFrame. RECOMMANDÉE
4.0 Découverte des pièces jointes
  4,1 Si une pièce jointe nécessite l'envoi d'un élève, elle DOIT inclure un studentWorkReviewUri pour qu'elle soit considérée comme un type d'activité et non comme une pièce jointe de type contenu. REQUIRED
  4.2 L'iFrame de découverte de pièces jointes DOIT fournir une interface utilisateur proposant au moins l'un des éléments suivants:
  • Créer le contenu à joindre
  • Parcourir, sélectionner et joindre un contenu à partir d'une bibliothèque de contenu
  • Instructions pour joindre des contenus provenant de votre site Web ou d'autres produits
REQUIRED
  4.3 L'enseignant DOIT accéder à l'ensemble des contenus et activités proposés par l'enseignant. RECOMMANDÉE
  4.4 L'enseignant DOIT pouvoir prévisualiser le contenu ou l'activité avant de s'engager à les joindre au devoir. REQUIRED
  4.5 Si l'enseignant a besoin de travailler pour créer du contenu ou une activité avant de pouvoir les joindre, vous DEVEZ les effectuer dans l'iFrame. RECOMMANDÉE
5.0 Vue élève
  5.1 Lorsque studentViewUri est lancé, le module complémentaire NE DOIT PAS sortir l'utilisateur de l'iFrame pour effectuer une tâche.
Si le module complémentaire sort l'utilisateur de l'iFrame, un message ou une autre indication doit s'afficher pour que les élèves retournent dans Classroom.
RECOMMANDÉE
  5.2 Si une activité du module complémentaire sort de l'iFrame, un aperçu de la tâche DOIT s'afficher dans l'iFrame. REQUIRED
  5,3 Si une activité nécessite qu'un élève effectue une action pour marquer son devoir comme terminé, le bouton NE DOIT PAS être intitulé "Rendre le devoir" pour éviter toute confusion avec le bouton de remise du devoir dans Classroom. REQUIRED
6,0 Vue "Enseignants"
  6,1 L'enseignant DOIT voir ce que l'élève voit lorsqu'il fait le devoir. RECOMMANDÉE
7,0 Récapitulatif des devoirs des élèves
  7,1 Si studentWorkReviewUri est lancé, le module complémentaire DOIT afficher le travail de cet élève pour que les enseignants l'examinent dans l'iFrame. Les documents complémentaires peuvent être reliés en dehors de l'iFrame. REQUIRED
  7.2 Le module complémentaire NE DOIT PAS permettre la navigation entre les élèves dans la vue studentWorkReviewUri. La navigation entre les élèves DOIT uniquement s'effectuer dans l'interface utilisateur de Classroom. REQUIRED
8,0 Assistance Classroom pour mobile
  8.1 Lorsque l'application mobile Classroom lance un teacherViewUri, un studentViewUri ou un 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 s'afficher pour l'utilisateur afin de l'informer qu'il s'agit d'un appareil non compatible et, dans l'idéal, de connaître les appareils compatibles. REQUIRED
  8.2 Les élèves DOIVENT pouvoir faire leur travail sur un appareil mobile. RECOMMANDÉE
9,0 Autres fonctionnalités
  9,1 S'ils peuvent coller des liens vers votre contenu en tant que pièces jointes de liens, vous DEVEZ convertir les liens en pièces jointes de modules complémentaires. RECOMMANDÉE
  9.2 Si vous utilisez une intégration CourseWork pour créer des devoirs en dehors de Classroom, vous DEVEZ créer des pièces jointes de modules complémentaires par défaut pour tous les liens compatibles avec votre module complémentaire. RECOMMANDÉE

Journal des modifications

Version 1.0 Mise à jour : 30 avril 2024
1,1 Combiner 1.1 et 1.2 en une seule exigence.
2.1 Combiner 2.1 et 2.5 en une seule exigence.
2.2 Combiner 2.2, 2.3 et 2.4 en une seule exigence.
3,5 Combiner 3.5, 3.6 et 3.7 en une seule exigence.
3,10 Ajout d'une condition selon laquelle le module complémentaire ne passe jamais dans un état inintelligible ou irrécupérable.
3.11, 3.12 Combinaison des versions 5.5, 5.6, 6.3, 6.4, 7.5 et 7.6 dans deux nouvelles exigences.
4.2 Description des expériences acceptables de découverte de pièces jointes.
4.3 Elle a été renumérotée (anciennement 4.2). Également passé de REQUIRED à RECOMMANDÉ.
4.4 Renuméroté (anciennement 4.3).
4.5 Renuméroté (anciennement 4.4).
5.2 Elle a été renumérotée (anciennement 5.3).
5,3 Elle a été renumérotée (anciennement 5.2).
9,1 Ajout d'une recommandation visant à mettre à niveau les liens collés vers les pièces jointes.
9.2 Ajout d'une exigence permettant de créer par défaut des pièces jointes de modules complémentaires lorsque vous créez des devoirs CourseWork par programmation.
2,6, 3,7, 3,8, 6,2, 7,3, 7,4 Supprimé.
Version 0.3 Mise à jour : 22 novembre 2022
2.3 Correction des conseils de connexion.
2.4 Intégration d'un scénario dans lequel l'implémentation de hd est requise.
3.2 Reformulation du terme "fournir un chemin d'accès".
5,5, 5,6, 6,3, 6,4, 7,5, 7,6 Ajout des consignes requises et recommandées pour studentViewUri, teacherViewUri et studentWorkReviewUri.
Version 0.2 Mise à jour : 29 octobre 2021
1,3 Modification du texte pour qu'il soit plus clair sur l'intention.
3.1 Ajout du message "Le module complémentaire DOIT respecter les consignes générales d'approbation GWM indiquées sur le site Web."
3.9 Les WCAG ont changé de REQUIRED à RECOMMANDÉ.
5.1 Remplacement de "REQUIRED" par "RECOMMENDED" (RECOMMANDÉ).
5,3 Ajout : "Si le module complémentaire sort de l'iFrame, il DOIT y avoir un aperçu de la tâche dans l'iFrame".
5.4 Ajout du message suivant : "Si le module complémentaire sort de l'iFrame, les élèves DOIVENT voir un message les invitant à retourner dans Classroom."
8.1 Ajout : "Si l'appareil n'est pas compatible, un message DOIT s'afficher pour l'utilisateur afin de lui indiquer qu'il s'agit d'un appareil non compatible et, dans l'idéal, de connaître les appareils compatibles."
8.2 Devoir "Obligatoire" pour les devoirs sur mobile a été remplacé par "RECOMMANDÉ".
Version 0.1 Mis à jour le 22 septembre 2021
  Version initiale.