Questions fréquentes

Afficher, créer et modifier des devoirs dans Classroom

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

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

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

Voici quelques exemples de cas d'utilisation de CourseWork:

  • Les carnets de notes, le SIS ou les systèmes de création de rapports peuvent synchroniser les devoirs et les notes depuis Classroom vers 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 font un devoir, les applications peuvent le rendre, définir des notes, le joindre et le 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 les devoirs contenant des pièces jointes de votre module complémentaire.

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

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 de l'API de mutation d'attribution doivent utiliser le même ID de projet Google Cloud que celui stocké au moment de la création de l'attribution.

Les modules complémentaires Google Classroom font l'objet d'une exception à cette règle. Un projet Cloud peut accéder aux annonces, aux devoirs ou aux supports comportant une ou plusieurs de ses pièces jointes de modules complémentaires, ou les modifier. Un projet Cloud peut également rendre, récupérer ou rendre un devoir associé à un ou plusieurs de ses modules complémentaires.

Les requêtes API nécessitent également les champs d'application utilisateur appropriés. Les enseignants peuvent consulter les devoirs, en créer, joindre des liens aux devoirs remis et définir des notes. Les élèves peuvent consulter leurs devoirs, joindre des liens vers leur dossier, et les rendre et les récupérer. Les administrateurs de domaine peuvent afficher CourseWork, mais ne disposent d'aucune autorisation en écriture.

Quels types d'éléments ma demande peut-elle joindre à un devoir ou à un envoi ?

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 Forms natifs.

Les utilisateurs finaux savent-ils que mon application a créé des devoirs dans Classroom ?

Oui. L'interface utilisateur de Classroom identifie les devoirs créés en externe à l'aide du nom de produit du projet Google Cloud qui les a créés. Les utilisateurs peuvent signaler une tâche créée en externe comme étant indésirable et déconnecter l'application qui l'a créée en révoquant tous les identifiants qui lui ont été fournis 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 une attribution, la requête doit utiliser le même projet Google Cloud que celui qui l'a créée.

Puis-je répondre à des questions dans l'API ?

Pas encore. Vous pouvez créer et modifier des questions. Répondre aux questions par programmation est sur notre feuille de route.

Modules complémentaires Classroom

Configuration du projet

Puis-je convertir le projet Google Cloud privé que j'ai utilisé pendant le développement en projet public utilisable 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 listes GWM ?

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

Il est toutefois possible de grouper des modules complémentaires. Cela permet de représenter plusieurs modules complémentaires sur une même liste GWM. L'installation à partir de cette liste entraîne l'installation de tous les modules complémentaires de l'app bundle en même temps. Les utilisateurs doivent autoriser tous les champs d'application requis par les modules complémentaires groupés lors de l'autorisation.

Deux points supplémentaires sont à prendre en compte concernant les offres groupées:

  1. Seuls les abonnés aux éditions Teaching and Learning Upgrade ou Education Plus peuvent utiliser les modules complémentaires Classroom.

  2. L'API des modules complémentaires est disponible en accès anticipé. Elle est limitée aux développeurs participants et aux projets Google Cloud. Les modules complémentaires groupés peuvent ne pas fonctionner comme prévu s'ils reposent sur des projets Google Cloud non participants.

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, les clients OAuth d'un projet Google Cloud autre que le projet Google Cloud du module complémentaire Classroom ne peuvent 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 tailles de logo disponibles dans la barre de titre de l'iFrame ?

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. Il est donc recommandé d'utiliser le même logo dans l'espace pour assurer la cohérence de la marque.

Domaines

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

Les administrateurs de l'établissement scolaire ont la possibilité de contrôler quels enseignants peuvent voir un module complémentaire installé.

Comment les administrateurs de domaine interagissent-ils avec les modules complémentaires ?

Les administrateurs de domaine (administrateurs) déterminent 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 administrateur. Si votre module complémentaire peut être installé individuellement, notez que la plupart des administrateurs gèrent une liste d'autorisation. Les enseignants peuvent installer eux-mêmes les modules complémentaires qui figurent 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 complémentaires dans une vue administrateur sur votre propre site.

API

Quel moyen fiable pouvez-vous utiliser pour savoir si la page du partenaire est chargée dans un iFrame ou dans une fenêtre externe ?

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

Quels éléments de travail attribuables font l'objet d'un iFrame "Examen des devoirs des élèves" ?

L'iFrame de l'évaluation 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 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 correspondant à une activité.

Existe-t-il des modifications destructives de l'API pendant le programme en accès anticipé ?

L'API des modules complémentaires est en cours de développement. Par conséquent, des modifications destructives de l'API peuvent entraîner l'échec des requêtes ayant abouti ou le comportement différent. Vous pouvez être informé à l'avance de toute modification destructive via le forum des développeurs.

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 des pièces jointes de votre module complémentaire. Vous pouvez reclaim, return ou turnIn un CourseWork StudentSubmission.

Quand les modules complémentaires Classroom seront-ils disponibles publiquement ?

Les modules complémentaires Classroom sont disponibles pour tous les utilisateurs finaux depuis l'été 2022. L'API des modules complémentaires devrait être accessible à tous les développeurs dans le courant de l'année 2024.

Authentification unique

Oui, il peut toujours utiliser Google Sign-In.

Tous les élèves disposent-ils d'une adresse e-mail valide, même s'ils n'ont pas accès à Gmail ?

Chaque utilisateur de Google Workspace for Education possède 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 à tout service Google particulier (y compris Gmail) sont distincts. Ainsi, même si Gmail est désactivé, les étudiants peuvent se connecter avec leur adresse e-mail.

L'administrateur de l'établissement doit-il pré-approuver l'application pour que les élèves puissent se connecter ?

Les administrateurs de domaine doivent ajouter un module complémentaire à la liste d'autorisation avant de pouvoir l'installer. Les administrateurs de domaine peuvent éventuellement installer un module complémentaire pour tous les utilisateurs du domaine ou d'une unité organisationnelle.

Commentaires et questions d'ordre général

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 elles dans notre outil public Issue Tracker.

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 des 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 à l'aide du tag google-classroom.