Version 1.1, 5 décembre 2024.
Les critères de cette page s'appliquent à tous les modules complémentaires Classroom. Votre module complémentaire doit respecter tous les éléments obligatoires applicables pour être approuvé et listé dans Google Workspace Marketplace, et être un module complémentaire "Fonctionne avec Classroom".
Les mots clés "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" et "OPTIONAL" de ce document doivent être interprétés comme décrit dans la RFC 2119.
Conditions requises
| ID | Type | ||
|---|---|---|---|
| 1.0 | Licence de l'utilisateur final (le cas échéant) | ||
| 1.1 | Un message convivial DOIT s'afficher lorsque l'utilisateur ne dispose pas de licence. Le message DOIT indiquer clairement la raison pour laquelle le module complémentaire ne peut pas être utilisé et suggérer une procédure à suivre pour résoudre le problème. | RECOMMANDÉ | |
| 1.3 | La fiche Google Workspace Marketplace du module complémentaire DOIT spécifier les conditions de licence et d'abonnement pouvant être requises pour l'utiliser. Si le module complémentaire propose un niveau payant, la fiche Marketplace DOIT fournir un lien vers une page Web fournissant plus d'informations sur les tarifs ou sur la manière de contacter un vendeur. | RECOMMANDÉ | |
| 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 utilisateurs élèves sont invités à se connecter au module complémentaire, ils DOIVENT le faire à l'aide de l'authentification unique Google. |
REQUIRED | |
| 2.2 | Le module complémentaire DOIT utiliser l'authentification unique Google pour connecter automatiquement un utilisateur lors de ses visites ultérieures sans afficher d'invite de connexion. Lorsque l'indice de connexion ne correspond pas à l'utilisateur actuellement connecté, le module complémentaire DOIT afficher un bouton de connexion et transmettre l'indice de connexion à 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 indiqué par l'indice de connexion), le module complémentaire DOIT présenter un bouton "Se connecter avec Google" pour que l'utilisateur effectue une action explicite afin de déclencher le processus de connexion. Remarque: Cela est nécessaire pour respecter les consignes relatives au branding Google et permet également d'éviter les bloqueurs de pop-ups. |
REQUIRED | |
| 2,8 | Le module complémentaire DOIT indiquer l'identité de l'utilisateur actuellement connecté. | RECOMMANDÉ | |
| 3.0 | Général | ||
| 3.1 | Le module complémentaire DOIT respecter les consignes générales d'approbation 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 en iframe, un message convivial doit être affiché pour inviter l'utilisateur à revenir dans Classroom. | RECOMMANDÉ | |
| 3.3 | L'utilisateur DOIT suivre le parcours uniquement à l'aide d'un workflow de module complémentaire et ne pas passer à un workflow de cours ni 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É | |
| 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és (recommandé) OU lorsque l'enseignant ouvre le devoir dans l'iframe d'évaluation des devoirs des élèves. |
REQUIRED | |
| 3.9 | Les modules complémentaires DOIVENT respecter les consignes d'accessibilité des WCAG 2.1, niveau AA. Les développeurs de modules complémentaires doivent déclarer eux-mêmes que cette exigence est remplie au moment de l'envoi et que le module complémentaire continue de respecter les futures modifications apportées. | RECOMMANDÉ | |
| 3,10 | Toutes les erreurs rencontrées par un utilisateur DOIVENT être lisibles par l'humain. | RECOMMANDÉ | |
| 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 | |
| 4,0 | Découverte des pièces jointes | ||
| 4.1 | Si une pièce jointe nécessite une remise par un élève, elle DOIT inclure un studentWorkReviewUri afin qu'elle soit traitée comme un type d'activité et non comme une pièce jointe de type de contenu. |
REQUIRED | |
| 4.2 | L'iframe de découverte des pièces jointes DOIT fournir une interface utilisateur qui propose au moins l'une des fonctionnalités suivantes:
|
REQUIRED | |
| 4.3 | L'enseignant DOIT pouvoir trouver et accéder à tous les contenus/activités qui lui sont disponibles. | RECOMMANDÉ | |
| 4.4 | L'enseignant DOIT pouvoir prévisualiser le contenu/l'activité avant de s'engager à l'associer au devoir. | RECOMMANDÉ | |
| 4.5 | Si l'enseignant doit effectuer des tâches pour créer un contenu/une activité avant de pouvoir l'ajouter, ces tâches DOIVENT être effectuées dans l'iFrame. | RECOMMANDÉ | |
| 5.0 | Vue de l'élève | ||
| 5.1 | Lorsque le studentViewUri est lancé, le module complémentaire NE DOIT PAS faire sortir l'utilisateur de l'iFrame pour qu'il effectue une tâche.Si le module complémentaire fait sortir l'utilisateur de l'iFrame, un message ou une autre indication doit indiquer aux élèves de revenir dans Classroom. |
RECOMMANDÉ | |
| 5.2 | Si une activité de module complémentaire s'affiche en dehors de l'iframe, un aperçu de la tâche devrait s'afficher dans l'iframe. | RECOMMANDÉ | |
| 5,3 | Le cas échéant, un bouton ou un lien de l'activité intitulé Rendre le devoir DOIT déclencher une requête API pour envoyer le travail de l'élève à l'enseignant. | REQUIRED | |
| 6.0 | Vue de l'enseignant | ||
| 6,1 | L'enseignant DOIT pouvoir voir ce que l'élève verra lorsqu'il réalisera le devoir. | RECOMMANDÉ | |
| 7.0 | Examen des travaux des élèves | ||
| 7.1 | Si le studentWorkReviewUri est lancé, le module complémentaire DOIT afficher le travail de l'élève pour que l'enseignant puisse le consulter dans l'iFrame. Les documents complémentaires peuvent comporter des liens 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 se faire uniquement dans l'interface utilisateur de Classroom. |
REQUIRED | |
| 8.0 | Compatibilité avec l'application mobile Classroom | ||
| 8.1 | Lorsque l'application mobile Classroom lance un teacherViewUri, studentViewUri ou studentWorkReviewUri, l'URL DOIT ouvrir l'application mobile native ou l'application Web mobile du partenaire, et dans les deux cas, rediriger vers la vue appropriée. Si l'appareil n'est pas compatible, un message DOIT s'afficher pour indiquer à l'utilisateur qu'il ne l'est pas et, dans l'idéal, les appareils compatibles. |
REQUIRED | |
| 8.2 | Les devoirs des élèves DOIVENT pouvoir être réalisés sur un appareil mobile. | RECOMMANDÉ | |
| 9.0 | Autres fonctionnalités | ||
| 9,1 | Si les enseignants peuvent coller des liens vers votre contenu en tant que pièces jointes de lien, vous DEVEZ convertir les liens en pièces jointes de modules complémentaires. | RECOMMANDÉ | |
| 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 module complémentaire par défaut pour tous les liens compatibles avec votre module complémentaire. | RECOMMANDÉ | |
Journal des modifications
| Version 1.1 | Mise à jour : 5 décembre 2024 |
| 1.1, 1.3, 3.2, 3.10, 4.4, 5.2 | Modification de la valeur "OBLIGATOIRE" en "RECOMMANDÉ". |
| 3.12 | Supprimé. |
| 5,3 | Réécrit. Une modification récente permet aux développeurs de modules complémentaires de rendre les devoirs des élèves de manière fiable à l'aide de l'API. |
| Version 1.0 | Mise à jour le 30 avril 2024 |
| 1.1 | Les exigences 1.1 et 1.2 ont été combinées en une seule. |
| 2.1 | Les exigences 2.1 et 2.5 ont été combinées en une seule exigence. |
| 2.2 | Les exigences 2.2, 2.3 et 2.4 ont été combinées en une seule exigence. |
| 3.5 | Les exigences 3.5, 3.6 et 3.7 ont été combinées en une seule exigence. |
| 3,10 | Ajout de l'exigence que le module complémentaire ne passe jamais dans un état inintelligible ou irrécupérable. |
| 3.11, 3.12 | Les exigences 5.5, 5.6, 6.3, 6.4, 7.5 et 7.6 ont été combinées en deux nouvelles exigences. |
| 4.2 | Description détaillée des expériences de découverte d'éléments joints acceptables. |
| 4.3 | Nouvelle numérotation, anciennement 4.2. Le niveau d'exigence est également passé de "OBLIGATOIRE" à "RECOMMANDÉ". |
| 4.4 | Ancien numéro 4.3. |
| 4.5 | Nouvelle numérotation, anciennement 4.4. |
| 5.2 | Nouvelle numérotation, anciennement 5.3. |
| 5,3 | Anciennement numéro 5.2. |
| 9,1 | Ajout d'une recommandation pour convertir des liens collés en pièces jointes. |
| 9.2 | Ajout d'une recommandation pour créer des pièces jointes de modules complémentaires par défaut lors de la création de devoirs CourseWork de manière programmatique. |
| 2.6, 3.7, 3.8, 6.2, 7.3, 7.4 | Supprimé. |
| Version 0.3 | Mise à jour le 22 novembre 2022 |
| 2.3 | Correction des conseils concernant les indices de connexion. |
| 2.4 | Intégration d'un scénario dans lequel l'implémentation de hd est requise. |
| 3.2 | Modification de la formulation "fournir un chemin d'accès". |
| 5.5, 5.6, 6.3, 6.4, 7.5, 7.6 | Ajout de conseils requis et recommandés pour le texte du cours pour les éléments studentViewUri, teacherViewUri et studentWorkReviewUri. |
| Version 0.2 | Mise à jour le 29 octobre 2021 |
| 1.3 | Ajustement du texte pour clarifier l'intention. |
| 3.1 | Ajout de la phrase "Le module complémentaire DOIT respecter les consignes générales d'approbation de GWM disponibles sur son site Web." |
| 3.9 | Les WCAG ont remplacé l'attribut "OBLIGATOIRE" par "RECOMMANDÉ". |
| 5.1 | Modification de l'état "OBLIGATOIRE" en "RECOMMANDÉ". |
| 5,3 | Ajout de la phrase "Si les modules complémentaires s'affichent en dehors de l'iFrame, un aperçu de la tâche doit s'afficher dans l'iFrame." |
| 5.4 | Ajout de la phrase "Si le module complémentaire s'affiche en dehors de l'iFrame, une invite devrait inviter les élèves à revenir dans Classroom." |
| 8.1 | Ajout de la section "Si l'appareil n'est pas compatible, un message DOIT s'afficher pour indiquer à l'utilisateur qu'il ne l'est pas et, dans l'idéal, les appareils compatibles." |
| 8.2 | Le devoir sur mobile est passé de REQUIRED à RECOMMENDED. |
| Version 0.1 | Mise à jour le 22 septembre 2021 |
| Version initiale. |