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 le travail d'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
CourseWork - Joindre des supports (fichiers Drive, vidéos YouTube, liens) à
CourseWork - Modifier l'état du devoir d'un élève (remise, retour, récupération)
- Attribuer une note à un devoir envoyé
- Joindre des supports (fichiers Drive, vidéos YouTube, liens) à devoirs remis par les é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 à leurs applications, éliminant ainsi les données manuelles transfert
- Les applications d'apprentissage peuvent créer des devoirs qui s'affichent dans le cours. flux. À mesure que les élèves terminent leur travail, les applications peuvent rendre leur travail, les notes, joindre les devoirs des élèves et les stocker de manière appropriée dossiers Drive.
- Les enseignants peuvent créer des devoirs avec des pièces jointes de modules complémentaires à partir de votre d'un site Web ou d'une application spécifiques.
- Les élèves peuvent rendre les devoirs comportant votre module complémentaire et les pièces jointes.
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 les travaux qu'elle crée. Autrement dit, toutes les requêtes de l'API de mutation d'attribution doivent utiliser le même ID de projet Google Cloud que a été stocké au moment de la création de l'attribution.
Les modules complémentaires Google Classroom font exception à cette règle. A peut accéder à n'importe quelle annonce, attribution ou un support comportant une ou plusieurs pièces jointes de ce module complémentaire. A Google Cloud peut aussi rendre, récupérer ou rendre un devoir comporte un ou plusieurs modules complémentaires en pièce jointe.
Les requêtes API nécessitent également les champs d'application utilisateur appropriés. Les enseignants peuvent voir
des devoirs, créer des devoirs, joindre des liens aux envois de devoirs et définir
de l'envoi des notes. Les élèves peuvent consulter les devoirs et joindre des liens à leurs
les enregistrements des devoirs, remettre
et récupérer leurs devoirs. Domaine
Les administrateurs peuvent afficher CourseWork, mais ne disposent d'aucune autorisation d'écriture.
Quels types d'éléments ma candidature peut-elle joindre à un devoir ou à un devoir ?
L'API permet de joindre des fichiers Drive, des vidéos YouTube et . Il n'est pas encore possible de joindre des formulaires Google Forms natifs.
Les utilisateurs finaux savent-ils qu'un devoir dans Classroom a été créé par mon application ?
Oui. L'UI de Classroom identifie les devoirs créés en externe. en utilisant le nom de produit du projet Google Cloud qui a créé la tâche. Les utilisateurs peuvent signaler les travaux créés en externe comme indésirables, et dissocier le l'application qui a créé la tâche, en révoquant les identifiants émis pour le compte application par l'utilisateur.
Bouton de partage Classroom et autres intégrations
J'ai déjà intégré le bouton de partage de 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 identifiant Google Cloud projet qui a créé le devoir.
Puis-je répondre aux questions dans l'API ?
Pas encore. Vous pouvez créer et modifier des questions. Répondre aux questions programmatique fait partie de notre feuille de route.
Modules complémentaires Classroom
Configuration du projet
Puis-je convertir un projet Google Cloud privé 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. Il vous en faut deux des projets distincts, l'un pour le développement et l'autre pour la production.
Un même projet Google Cloud peut-il posséder deux fiches Google Workspace Marketplace ?
Non. Vous ne pouvez pas créer deux fiches Google Workspace Marketplace pour une un seul projet Google Cloud.
Il est toutefois possible de grouper des modules complémentaires. Cela permet à une seule Fiche Google Workspace Marketplace représentant plusieurs modules complémentaires. Installation à partir d'une telle liste installerait tous les modules complémentaires du pack une seule fois. Les utilisateurs doivent donner leur autorisation pour toutes les portées requises par les modules complémentaires groupés lors de l'autorisation.
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, il s'agit d'un client OAuth d'un projet Google Cloud autre que le Le projet Google Cloud du module complémentaire Classroom ne peut pas fonctionner. Jetons d'accès générées par un autre projet Google Cloud sont refusées par l'API Classroom. Vous devez créer un client OAuth distinct pour le projet du module complémentaire.
Expérience utilisateur
Notre logo n'est pas adapté à un petit carré. Quelles sont les tailles disponibles pour les logos dans la barre de titre de l'iFrame ?
La barre de titre iFrame a été conçue pour n'accepter qu'un logo carré de 32 x 32 pixels. Ce a été choisi de correspondre à la forme du favicon que les entreprises utilisent sur leurs sites Web. Nous vous conseillons d'utiliser le même logo pour assurer la cohérence de la marque.
Domaines
Les enseignants et les élèves du même domaine ont-ils tous accès au module complémentaire installé ?
Les administrateurs des établissements scolaires peuvent contrôler quels enseignants sont autorisés à voir une installé. Seuls les utilisateurs peuvent utiliser les modules complémentaires Classroom avec un cours Learning ou Education Plus.
Comment les administrateurs de domaine interagissent-ils avec les modules complémentaires ?
Les administrateurs de domaine (administrateurs) déterminent qui est autorisé à utiliser votre module complémentaire. Ils peuvent installer un module complémentaire pour tout un domaine à l'aide de la fonction d'installation l'option. Si votre module complémentaire peut être installé individuellement, notez que la plupart Les administrateurs conservent une liste d'autorisation de modules complémentaires. les enseignants peuvent installer des modules complémentaires qui figurent sur cette liste. Un administrateur peut également choisir de installer individuellement votre module complémentaire à des fins de test.
Les administrateurs peuvent également être intéressés par les statistiques d'utilisation concernant vos un module complémentaire. Si votre produit le permet, envisagez de fournir des statistiques d'utilisation des modules complémentaires dans une vue administrateur de votre propre site.
API
Quel moyen fiable permet de savoir si la page du partenaire est chargée dans un onglet iFrame ou dans une fenêtre externe ?
Il n'existe actuellement aucune méthode permettant de les distinguer.
Quels éléments de travail attribuables obtiennent un iFrame sur l'examen des devoirs des élèves ?
L'iFrame de révision des devoirs des élèves n'est fourni que pour les pièces jointes de type activité.
Appelez la méthode courses.courseWork.getAddOnContext pour savoir si le post
est compatible avec le travail des élèves. Le champ supportsStudentWork ne peut être que true
pour un type de post correspondant à 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 pièce jointe de votre module complémentaire.
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 Google Sign-In ?
Oui, il peut toujours utiliser Google Sign-In.
Chaque élève dispose-t-il d'une adresse e-mail valide, même s'il n'a pas accès à Gmail ?
Chaque utilisateur de Google Workspace for Education possède une identité Google, quel que soit le s'ils ont accès ou non à Gmail. Les identités sont représentées par un e-mail adresse e-mail. Identité et accès à tout service Google particulier (y compris Gmail) sont distinctes. Ainsi, même si Gmail est désactivé, les élèves peuvent se connecter son adresse e-mail.
L'administrateur de l'établissement doit-il pré-approuver l'application pour permettre aux élèves de se connecter ?
Pour pouvoir installer un module complémentaire, les administrateurs du domaine doivent l'ajouter à la liste d'autorisation. Les administrateurs de domaine ont la possibilité d'installer un module complémentaire pour tous les utilisateurs du domaine un domaine ou une unité organisationnelle.
Commentaires et questions générales
Comment envoyer des demandes de fonctionnalités ou des problèmes ?
Vous pouvez envoyer des demandes de fonctionnalités, les afficher et voter pour celles-ci dans notre problème public bracelet d'activité.
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, notre forum des développeurs et l'outil public Issue Tracker.
J'utilise l'API Classroom. Comment poser des questions techniques ?
Publiez vos questions sur Stack Overflow avec le tag google-classroom.