Afficher, créer et modifier des devoirs dans Classroom
Que puis-je créer avec les points de terminaison CourseWork de l'API Classroom ?
Les points de terminaison permettent aux développeurs de consulter et de gérer le travail dans un cours. Plus précisément, vous pouvez effectuer les opérations suivantes:
- Afficher les devoirs et les questions (appelés collectivement
CourseWork) d'un utilisateur - Créer, modifier et supprimer des
CourseWork - Joindre des supports (fichiers Drive, vidéos YouTube, liens) à
CourseWork - Modifier l'état de la remise d'un élève (par exemple, remise, rendu, récupération)
- Définir la note d'un devoir
- joindre des supports (fichiers Drive, vidéos YouTube, liens) aux devoirs des élèves ;
Voici quelques exemples de cas d'utilisation de CourseWork:
- Les cahiers de notes, les SIS ou les systèmes de reporting peuvent synchroniser les devoirs et les notes de Classroom avec leurs applications, ce qui élimine le transfert manuel des données.
- Les applications d'apprentissage peuvent créer des devoirs qui apparaissent dans le flux du cours. Lorsque les élèves terminent leur devoir, les applications peuvent le rendre, définir des notes, joindre le devoir des élèves et le stocker dans les dossiers Drive appropriés.
- Les utilisateurs enseignants peuvent créer des devoirs avec des pièces jointes de modules complémentaires à partir de votre site Web ou de votre application.
- Les utilisateurs élèves peuvent rendre leurs devoirs contenant des pièces jointes de votre module complémentaire.
De quelles autorisations ma demande a-t-elle besoin pour créer ou modifier des devoirs ?
En règle générale, une application ne peut modifier que le travail qu'elle crée. En d'autres termes, toutes les requêtes d'API de modification d'un devoir doivent utiliser le même ID de projet Google Cloud que celui stocké au moment de la création du devoir.
Les modules complémentaires Google Classroom font exception à cette règle. Un projet Cloud peut accéder ou modifier toute annonce, devoir ou ressource contenant un ou plusieurs de ses fichiers joints de modules complémentaires. Un projet Cloud peut également rendre, récupérer ou renvoyer un devoir qui comporte un ou plusieurs de ses fichiers joints d'extensions.
Les requêtes API nécessitent également les étendues utilisateur appropriées. Les enseignants peuvent consulter les devoirs, en créer, joindre des liens aux devoirs rendus et définir des notes. Les élèves peuvent afficher les devoirs, joindre des liens à leurs devoirs, les rendre et les récupérer. Les administrateurs de domaine peuvent afficher CourseWork, mais ne disposent pas d'autorisations en écriture.
Quels types d'éléments mon application peut-elle joindre à un devoir ou à une soumission ?
L'API permet d'ajouter des fichiers Drive, des vidéos YouTube et des liens. Vous ne pouvez pas encore joindre de formulaires Google Forms natifs.
Les utilisateurs finaux savent-ils qu'un devoir dans Classroom a été créé par mon application ?
Oui. L'interface utilisateur de Classroom identifie les devoirs créés en externe à l'aide du nom du produit du projet Google Cloud qui a créé le devoir. Les utilisateurs peuvent signaler un travail créé en externe comme indésirable, et dissocier l'application qui l'a créé en révoquant les identifiants émis par l'utilisateur pour l'application.
Bouton de partage dans Classroom et autres intégrations
J'ai déjà intégré le bouton de partage Classroom. Puis-je modifier un devoir créé à l'aide du bouton de partage ?
Pas encore. Pour modifier un devoir, la requête doit utiliser le même projet Google Cloud que celui utilisé pour le créer.
Puis-je répondre aux questions dans l'API ?
Pas encore. Vous pouvez créer et modifier des questions.
Modules complémentaires Classroom
Configuration du projet
Puis-je convertir un projet Google Cloud privé que j'ai utilisé pendant le développement en projet public que je peux utiliser en production ?
Vous ne pouvez pas convertir un projet Google Cloud privé en projet public. Vous avez besoin de deux projets distincts, l'un pour le développement et l'autre pour la production.
Un même projet Google Cloud peut-il avoir deux fiches sur Google Workspace Marketplace ?
Non. Vous ne pouvez pas créer deux fiches Google Workspace Marketplace pour un même projet Google Cloud.
Vous pouvez toutefois grouper des modules complémentaires. Cela permet à une seule fiche Google Workspace Marketplace de représenter plusieurs modules complémentaires. L'installation à partir d'une telle liste installerait tous les modules complémentaires du lot en même temps. Les utilisateurs doivent donner leur consentement pour tous les champs d'application requis par les modules complémentaires groupés lors de l'autorisation.
Un client OAuth d'un autre projet Google Cloud peut-il être réutilisé avec un projet Google Cloud pour les modules complémentaires Classroom ?
Non, un client OAuth d'un projet Google Cloud autre que le projet Google Cloud du module complémentaire Classroom ne peut pas fonctionner. Les jetons d'accès générés par un autre projet Google Cloud sont refusés par l'API Classroom. Vous devez créer un client OAuth distinct pour le projet de module complémentaire.
Expérience utilisateur
Notre logo ne s'adapte pas bien à un petit carré. Quelles sont les options de taille disponibles pour les logos dans la barre de titre de l'iFrame ?
La barre de titre de l'iFrame n'est conçue que pour accepter un logo carré de 32 x 32 pixels. Ce choix a été fait pour correspondre à la forme de la favicon que les entreprises utilisent sur leurs sites Web. Nous vous recommandons d'utiliser le même logo dans l'espace pour une cohérence de la marque.
Domaines
Tous les enseignants et les élèves du même domaine ont-ils accès à un module complémentaire installé ?
Les administrateurs scolaires peuvent contrôler les enseignants qui peuvent voir un module complémentaire installé. Les modules complémentaires Classroom ne sont utilisables que par les utilisateurs disposant d'une licence Teaching and Learning ou Education Plus.
Comment les administrateurs de domaine interagissent-ils avec les modules complémentaires ?
Les administrateurs de domaine contrôlent les utilisateurs autorisés à utiliser votre module complémentaire. Ils peuvent installer un module complémentaire pour l'ensemble d'un domaine à l'aide de l'option d'installation de l'administrateur. Si votre module complémentaire peut être installé individuellement, notez que la plupart des administrateurs gèrent une liste d'autorisation de modules complémentaires. Les enseignants peuvent installer eux-mêmes les modules complémentaires figurant sur cette liste. Un administrateur peut également choisir d'installer individuellement votre module complémentaire à des fins de test.
Les administrateurs peuvent également être intéressés par les statistiques d'utilisation de votre module complémentaire. Si votre produit le permet, envisagez de fournir des statistiques d'utilisation des modules complémentaires dans une vue administrateur sur votre propre site.
API
Comment savoir de manière fiable si la page du partenaire est chargée dans un iFrame ou dans un onglet pop-up ?
Il n'existe actuellement aucune méthode permettant de faire la distinction entre les deux.
Quels éléments de travail pouvant être attribués sont associés à une iframe d'évaluation du travail des élèves ?
L'iframe d'évaluation du travail des élèves n'est fournie que pour les pièces jointes de type activité.
Appelez la méthode courses.courseWork.getAddOnContext pour savoir si le type de post est compatible avec les devoirs des élèves. Le champ supportsStudentWork ne peut être true que pour un type de post qui est une activité.
Une pièce jointe de module complémentaire peut-elle accéder à l'élément de flux auquel elle est associée ?
Oui. Vous pouvez get ou patch tout Announcement, CourseWork ou CourseWorkMaterial contenant au moins l'un de vos fichiers joints de modules complémentaires.
Vous pouvez reclaim, return ou turnIn un CourseWork StudentSubmission.
Authentification unique
Les élèves qui utilisent des badges Clever ou Classlink pour se connecter à leur Chromebook peuvent-ils utiliser la connexion Google ?
Oui, ils peuvent toujours utiliser la fonctionnalité Se connecter avec Google.
Chaque élève dispose-t-il d'une adresse e-mail correctement formatée, même s'il n'a pas accès à Gmail ?
Chaque utilisateur Google Workspace for Education dispose d'une identité Google, qu'il ait accès à Gmail ou non. Les identités sont représentées par une adresse e-mail. L'identité et l'accès à un service Google particulier (y compris Gmail) sont distincts. Ainsi, même si Gmail est désactivé, les utilisateurs étudiants peuvent se connecter avec leur adresse e-mail.
Un administrateur scolaire doit-il préapprouver l'application pour permettre aux élèves de se connecter ?
Les administrateurs de domaine doivent ajouter un module complémentaire à la liste d'autorisation avant qu'il ne puisse être installé. Les administrateurs de domaine peuvent également installer un module complémentaire pour tous les utilisateurs du domaine ou d'une unité organisationnelle.
Commentaires et questions générales
Comment envoyer des demandes de fonctionnalités ou signaler des problèmes ?
Vous pouvez envoyer, consulter et voter pour des demandes de fonctionnalités dans notre outil public de suivi des problèmes.
Comment savoir quand de nouvelles fonctionnalités sont disponibles dans l'API Classroom ?
Les mises à jour de l'API sont publiées sur la page des notes de version, sur notre forum pour les développeurs et dans l'outil public Issue Tracker.
J'utilise l'API Classroom. Comment poser des questions techniques ?
Posez vos questions sur Stack Overflow en ajoutant la balise google-classroom.