Questions fréquentes

Afficher, créer et modifier des devoirs dans Classroom

Que puis-je créer avec les points de terminaison de devoirs dans l'API Classroom ?

Les points de terminaison permettent aux développeurs d'afficher et de gérer les devoirs dans un cours. Plus précisément, vous pouvez effectuer les opérations suivantes :

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

Voici quelques exemples 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 élimine le transfert manuel des données.
  • Les applications d'apprentissage peuvent créer de nouveaux 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 de votre application.
  • Les élèves peuvent rendre leurs devoirs qui comportent des pièces jointes de modules complémentaires.

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 devoirs qu'elle crée. En d'autres termes, toutes les requêtes API visant à modifier des CourseWork doivent utiliser le même ID de projet Google Cloud que celui utilisé pour créer les CourseWork.

Les modules complémentaires Google Classroom font exception à cette règle. Un projet Cloud peut accéder à n'importe quelle annonce, devoir ou support de cours comportant une ou plusieurs de ses pièces jointes de modules complémentaires, ou le modifier. Un projet Cloud peut également rendre, récupérer ou retourner un devoir comportant une ou plusieurs de ses pièces jointes de modules complémentaires.

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

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

L'API permet de joindre des fichiers Drive, des vidéos YouTube et des liens. La pièce jointe de formulaires Google natifs n'est pas encore prise en charge.

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 de produit du projet Google Cloud qui a créé le devoir. Les utilisateurs peuvent signaler les devoirs créés en externe comme indésirables, ainsi que déconnecter l'application qui a créé le devoir en révoquant toutes les identifiants émis pour l'application par l'utilisateur.

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 requête 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é lors du développement en 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 seul 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 seul 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 installera alors tous les modules complémentaires du bundle en une seule fois. Les utilisateurs devront accepter 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 tient pas bien dans un petit carré. Quelles sont les options de taille pour les logos dans la barre de titre de l'iframe des modules complémentaires Classroom ?

La barre de titre de l'iframe a été conçue pour n'accepter qu'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 pour assurer la cohérence de la 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 de la licence Teaching &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 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 qui figurent sur cette liste peuvent installer eux-mêmes des modules complémentaires. 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 une 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 reçoivent une iframe de révision des devoirs des élèves ?

L'iframe de révision des devoirs des élèves n'est fournie que pour les pièces jointes de type activité. Appelez la méthode courses.courseWork.getAddOnContext pour déterminer si le type de post prend en charge 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 jointe ?

Oui. Vous pouvez get ou patch n'importe quel Announcement, CourseWork, ou CourseWorkMaterial contenant au moins une de vos pièces jointes de modules complémentaires. Vous pouvez reclaim, return ou turnIn un CourseWork StudentSubmission.

Authentification unique

Oui, ils peuvent toujours utiliser la connexion 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 ?

Tous les utilisateurs Google Workspace for Education disposent d'une identité Google, qu'ils aient 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. Il est donc recommandé d'utiliser les ID utilisateur comme clés primaires lors du stockage des informations utilisateur.

Un administrateur d'établissement scolaire doit-il préapprouver l'application pour autoriser les élèves à se connecter ?

Les administrateurs de domaine doivent ajouter un module complémentaire à la liste d'autorisation avant de pouvoir l'installer. 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 puis-je envoyer des demandes de fonctionnalités ou signaler des problèmes ?

Vous pouvez envoyer, afficher et voter pour des demandes de fonctionnalités 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 de suivi des problèmes.

J'utilise l'API Classroom. Comment puis-je poser des questions techniques ?

Posez vos questions sur Stack Overflow avec le google-classroom tag.