Les modules complémentaires Google Classroom sont désormais disponibles pour tous les développeurs. Pour en savoir plus, consultez la documentation sur les modules complémentaires.

Cette page a été traduite par l'API Cloud Translation.

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.

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 pourquoi le module complémentaire ne peut pas être utilisé et suggérer une procédure à suivre pour résoudre le problème.	REQUIRED
	1.3	La fiche Google Workspace Marketplace du module complémentaire DOIT indiquer les conditions de licence 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 procédure à suivre pour 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 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 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 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, elle DOIT fournir un message convivial pour revenir à Classroom.	REQUIRED
	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 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	Toutes les erreurs rencontrées par un utilisateur DOIVENT être lisibles 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` est lancé à partir d'un devoir ou d'un cours copié, le module complémentaire DOIT afficher une nouvelle pièce jointe à remplir par l'élève et NE DOIT PAS afficher les réponses de l'élève dans les devoirs ou cours précédents dans l'iFrame.	RECOMMANDÉ
4,0	Découverte de 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 de pièces jointes DOIT fournir une interface utilisateur offrant au moins l'un des éléments suivants: Créer un contenu à associer Parcourir, sélectionner et joindre des contenus à partir d'une bibliothèque de contenus Instructions pour joindre du contenu à partir de votre site Web ou d'autres produits	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'ajouter 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 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 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 le travail comme terminé, le bouton ne doit PAS être intitulé "Rendre le devoir", afin d'éviter toute confusion avec le bouton "Rendre le devoir" de Classroom.	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 avoir lieu 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 via un lien profond. 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 ê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 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	Les exigences 1.1 et 1.2 ont été combinées en une seule.
2.1	Combinaison des sections 2.1 et 2.5 en une seule condition.
2.2	Les exigences 2.2, 2.3 et 2.4 ont été combinées en une seule exigence.
3.5	Combinaison des sections 3.5, 3.6 et 3.7 en une seule condition.
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 plus détaillée des expériences acceptables pour la découverte de pièces jointes.
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	Ancien numéro 5.3.
5,3	Anciennement numéro 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 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	Le libellé "WCAG" a été remplacé par "RECOMMANDED" (OBLIGATOIRE).
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 du message "Si le module complémentaire sort du cadre iFrame, les élèves DOIVENT être invités à retourner dans Classroom."
8.1	Ajout de la phrase "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.