Questions fréquentes

Afficher, créer et modifier des travaux et 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 les devoirs dans un cours. Plus précisément, vous pouvez effectuer les opérations suivantes :

  • Affichez les devoirs et les questions (appelés collectivement CourseWork) d'un utilisateur.
  • Créer, modifier et supprimer des CourseWork.
  • Joignez des supports de cours (fichiers Drive, vidéos YouTube, liens) à CourseWork.
  • Modifier l'état d'un devoir d'élève (par exemple, rendu, renvoyé ou récupéré)
  • Définissez la note d'un devoir envoyé.
  • Joignez des supports de cours (fichiers Drive, vidéos YouTube, liens) aux devoirs des élèves.

Voici quelques exemples de cas d'utilisation de CourseWork :

  • Les carnets de notes, les SIS ou les systèmes de reporting peuvent synchroniser les devoirs et les notes de Classroom avec leurs applications, ce qui évite le transfert manuel des données.
  • Les applications pédagogiques peuvent créer des devoirs qui s'affichent dans le flux du cours. Lorsque les élèves terminent leurs devoirs, les applications peuvent les rendre, définir des notes, joindre les devoirs des élèves et les stocker dans les dossiers Drive appropriés.
  • Les enseignants peuvent créer des devoirs avec des pièces jointes de modules complémentaires à partir de votre site Web ou application.
  • Les élèves peuvent remettre les devoirs auxquels vous avez joint des pièces jointes d'extensions.

De quelles autorisations mon application a-t-elle besoin pour créer ou modifier des devoirs ?

En règle générale, une application ne peut modifier que les éléments qu'elle crée. En d'autres termes, toute requête d'API visant à modifier CourseWork doit utiliser le même ID de projet Google Cloud que celui utilisé pour créer CourseWork.

Les modules complémentaires Google Classroom font exception à cette règle. Un projet Cloud peut accéder à n'importe quelle annonce, devoir ou ressource comportant un ou plusieurs de ses modules complémentaires en pièce jointe, ou les modifier. Un projet Cloud peut également remettre, récupérer ou renvoyer un devoir qui comporte une ou plusieurs pièces jointes d'extensions.

Les requêtes API nécessitent également les scopes utilisateur appropriés. Les enseignants peuvent consulter les devoirs, en créer, joindre des liens aux devoirs rendus et attribuer des notes. Les élèves peuvent consulter les devoirs, joindre des liens à leurs devoirs, et rendre ou récupérer leurs devoirs. Les administrateurs de domaine peuvent afficher CourseWork, mais ne disposent pas des autorisations en écriture.

Quels types d'éléments mon application peut-elle joindre à des devoirs ou des devoirs remis ?

L'API permet de joindre des fichiers Drive, des vidéos YouTube et des liens. Il n'est pas encore possible de joindre des formulaires Google natifs.

Les utilisateurs finaux savent-ils qu'un devoir dans Classroom a été créé par mon application ?

Oui. L'interface utilisateur Classroom identifie les devoirs créés en externe à l'aide du nom de produit du projet Google Cloud qui a créé le devoir. Les utilisateurs peuvent signaler comme indésirables les contenus créés en externe, et déconnecter l'application qui les a créés en révoquant les identifiants qu'ils lui ont fournis.

Bouton de partage 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 demande doit utiliser le même projet Google Cloud que celui qui a créé le devoir.

Puis-je répondre à des 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 un projet public que je peux utiliser en production ?

Non, 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 Google Workspace Marketplace ?

Non. Vous ne pouvez pas créer deux fiches Google Workspace Marketplace pour un même projet Google Cloud.

Il est toutefois possible de regrouper 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 fiche permet d'installer tous les modules complémentaires du bundle en une seule fois. Lors de l'autorisation, les utilisateurs devront consentir à toutes les habilitations requises par les modules complémentaires groupés.

Est-il possible de réutiliser un client OAuth d'un autre projet Google Cloud avec un projet Google Cloud pour les modules complémentaires Classroom ?

Non, un client OAuth provenant 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'affiche pas correctement dans un petit carré. Quelles sont les options de taille disponibles pour les logos dans la barre de titre de l'iFrame des modules complémentaires Classroom ?

La barre de titre de l'iFrame n'était conçue que pour un logo carré de 32 x 32. Ce choix a été fait pour correspondre à la forme du favicon que les entreprises utilisent sur leurs sites Web. Nous vous recommandons d'utiliser le même logo dans l'espace prévu à cet effet pour assurer la cohérence de votre marque.

Domaines

Tous les enseignants et élèves du même domaine ont-ils accès à un module complémentaire installé ?

Les administrateurs de domaine peuvent contrôler les enseignants qui peuvent voir un module complémentaire installé. Les modules complémentaires Classroom ne peuvent être utilisés 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 qui peut 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 pour les administrateurs. Si votre module complémentaire peut être installé individuellement, notez que la plupart des administrateurs tiennent une liste d'autorisation des modules complémentaires. Les enseignants qui figurent sur cette liste peuvent installer des modules complémentaires pour eux-mêmes. 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 le contenu des modules complémentaires est chargé dans un iFrame ou dans un nouvel onglet ?

Il n'existe actuellement aucune méthode permettant de faire la distinction entre les deux.

Quels éléments de travail assignables disposent d'un iFrame de vérification des devoirs des élèves ?

L'iframe "Examen des devoirs des élèves" n'est disponible 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 défini sur 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 n'importe quel Announcement, CourseWork ou CourseWorkMaterial contenant au moins une de vos pièces jointes de module complémentaire. Vous pouvez reclaim, return ou turnIn un CourseWork StudentSubmission.

Authentification unique

Oui, ils peuvent toujours utiliser la connexion 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 possède une identité Google, qu'il ait ou non accès à Gmail. L'identité et l'accès à un service Google particulier (y compris Gmail) sont distincts. Même si Gmail est désactivé, les élèves peuvent se connecter à Classroom avec leur adresse e-mail. Les identités sont représentées par un ID utilisateur et une adresse e-mail. Un utilisateur Google Workspace for Education peut modifier son adresse e-mail. Nous vous recommandons donc d'utiliser des ID utilisateur comme clés primaires lorsque vous stockez des informations utilisateur.

Un administrateur de l'établissement 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 pour qu'il puisse être installé. Si vous le souhaitez, les administrateurs de domaine peuvent 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 des demandes de fonctionnalités, les consulter et voter pour celles qui vous intéressent dans notre outil public de suivi des problèmes.

Comment puis-je savoir quand de nouvelles fonctionnalités sont disponibles dans l'API Classroom ?

Les mises à jour de l'API sont publiées dans la newsletter 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 utilisant le tag google-classroom.