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 module complémentaire doit satisfaire à tous les critères requis pour que sa fiche sur Google Workspace Marketplace soit approuvée, ainsi qu'un module complémentaire compatible avec Classroom.

Dans ce document, les mots clés "OBLIGATOIRE", "NE DOIT PAS", "OBLIGATOIRE", "NE DEVRAIT PAS", "DEVRAIT", "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 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é, il 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é d'après l'indice de connexion), le module complémentaire DOIT inclure un bouton "Se connecter avec Google" pour que l'action explicite de l'utilisateur déclenche le processus de connexion.
Remarque: Cette étape est nécessaire pour respecter les consignes relatives à la marque Google et permet également d'éviter les blocages de 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 flux de travail 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 DEVRAIT ê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 a besoin de créer du contenu ou de l'activité avant de pouvoir le joindre, ce travail DOIT être effectué dans l'iFrame. RECOMMANDÉ
5.0 Vue élève
  5.1 Au lancement de studentViewUri, le module complémentaire NE DEVRAIT 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 que l'élève effectue une action pour marquer son devoir comme terminé, le bouton NE DOIT PAS être intitulé "Rendre" pour éviter toute confusion avec le bouton de remise en classe. REQUIRED
6,0 Vue enseignant
  6,1 L'enseignant DOIT être en mesure de voir ce que l'élève verra lorsqu'il aura fait 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 ne passe jamais dans un état inintelligible ou irrécupérable.
3,11, 3,12 Combinaison des sections 5.5, 5.6, 6.3, 6.4, 7.5 et 7.6 en deux nouvelles 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 à RECOMMENDED.
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 des pièces jointes de module complémentaire sont créées par défaut lors de la création automatisée de devoirs CourseWork.
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 requise.
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 d'approbation générales de GWM qui figurent sur son 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 suivant : "Si le module complémentaire sort de l'iFrame, il DOIT disposer d'un aperçu de la tâche dans l'iFrame."
5.4 Ajout du message "Si le module complémentaire sort du cadre iFrame, les élèves DOIVENT être invités à retourner dans Classroom."
8.1 Ajout : "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."
8.2 Le devoir mobile des élèves, REQUIRED, a été remplacé par RECOMMENDED.
Version 0.1 Mise à jour : 22 septembre 2021
  Version initiale.