Vos utilisateurs utilisent-ils Classroom avec Google Meet ? Consultez le guide de démarrage rapide d'Apps Script pour savoir comment vérifier la participation des élèves aux cours Google Meet.

Google Classroom API

Gère les cours, les listes d'élèves et les invitations dans Google Classroom.

Service: Classroom.googleapis.com

Pour appeler ce service, nous vous recommandons d'utiliser les bibliothèques clientes fournies par Google. Si votre application doit utiliser vos propres bibliothèques pour appeler ce service, utilisez les informations suivantes lorsque vous envoyez des requêtes d'API.

Document de découverte

Un document de découverte est une spécification exploitable par un ordinateur qui permet de décrire et de consommer les API REST. Ce document permet de créer des bibliothèques clientes, des plug-ins IDE et d'autres outils qui interagissent avec les API Google. Un même service peut fournir plusieurs documents de découverte. Ce service fournit le document de découverte suivant :

Point de terminaison de service

Un point de terminaison de service est une URL de base qui spécifie l'adresse réseau d'un service d'API. Un service peut avoir plusieurs points de terminaison de service. Ce service possède le point de terminaison de service suivant, et tous les URI ci-dessous sont relatifs à ce point de terminaison de service :

  • https://classroom.googleapis.com

Ressource REST: v1.courses

Méthodes
create POST /v1/courses
Crée un cours.
delete DELETE /v1/courses/{id}
Supprime un cours.
get GET /v1/courses/{id}
Renvoie un cours.
list GET /v1/courses
Renvoie une liste de cours que l'utilisateur à l'origine de la demande est autorisé à afficher, limités à ceux qui correspondent à la requête.
patch PATCH /v1/courses/{id}
Met à jour un ou plusieurs champs d'un cours.
update PUT /v1/courses/{id}
Met à jour un cours.

Ressource REST: v1.courses.aliases

Méthodes
create POST /v1/courses/{courseId}/aliases
Crée un alias pour un cours.
delete DELETE /v1/courses/{courseId}/aliases/{alias}
Supprime un alias d'un cours.
list GET /v1/courses/{courseId}/aliases
Renvoie une liste d'alias pour un cours.

Ressource REST : v1.courses.announcements

Méthodes
create POST /v1/courses/{courseId}/announcements
Crée une annonce.
delete DELETE /v1/courses/{courseId}/announcements/{id}
Supprime une annonce.
get GET /v1/courses/{courseId}/announcements/{id}
Renvoie une annonce.
list GET /v1/courses/{courseId}/announcements
Affiche une liste des annonces que le demandeur est autorisé à consulter.
modifyAssignees POST /v1/courses/{courseId}/announcements/{id}:modifyAssignees
Modifie le mode responsable et les options d'une annonce.
patch PATCH /v1/courses/{courseId}/announcements/{id}
Met à jour un ou plusieurs champs d'une annonce.

Ressource REST: v1.courses.courseWork

Méthodes
create POST /v1/courses/{courseId}/courseWork
Crée un devoir.
delete DELETE /v1/courses/{courseId}/courseWork/{id}
Supprime un devoir.
get GET /v1/courses/{courseId}/courseWork/{id}
Il rend les devoirs.
list GET /v1/courses/{courseId}/courseWork
Renvoie une liste de travaux que le demandeur est autorisé à consulter.
modifyAssignees POST /v1/courses/{courseId}/courseWork/{id}:modifyAssignees
Modifie le mode de gestion des devoirs et les options d'un devoir.
patch PATCH /v1/courses/{courseId}/courseWork/{id}
Met à jour un ou plusieurs champs d'un devoir.

Ressource REST: v1.courses.courseWork.studentSubmissions

Méthodes
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
Renvoie le devoir d'un élève.
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
Renvoie une liste des devoirs des élèves que le demandeur est autorisé à afficher, en tenant compte des champs d'application OAuth de la requête.
modifyAttachments POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments
Modifie les pièces jointes envoyées aux élèves.
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
Met à jour un ou plusieurs champs du devoir d'un élève.
reclaim POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim
Révoque le devoir d'un élève au nom de l'élève qui en est propriétaire.
return POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return
Renvoie le devoir d'un élève.
turnIn POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn
Remis le devoir d'un élève.

Ressource REST : v1.courses.courseWorkMaterials

Méthodes
create POST /v1/courses/{courseId}/courseWorkMaterials
Crée un devoir.
delete DELETE /v1/courses/{courseId}/courseWorkMaterials/{id}
Supprime un support de cours.
get GET /v1/courses/{courseId}/courseWorkMaterials/{id}
Renvoie un devoir.
list GET /v1/courses/{courseId}/courseWorkMaterials
Affiche une liste des devoirs que le demandeur est autorisé à consulter.
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{id}
Met à jour un ou plusieurs champs d'un support de cours.

Ressource REST : v1.courses.students

Méthodes
create POST /v1/courses/{courseId}/students
Ajoute un utilisateur en tant qu'élève d'un cours.
delete DELETE /v1/courses/{courseId}/students/{userId}
Supprime un élève d'un cours.
get GET /v1/courses/{courseId}/students/{userId}
Renvoie un élève d'un cours.
list GET /v1/courses/{courseId}/students
Renvoie une liste des élèves de ce cours que le demandeur est autorisé à consulter.

Ressource REST: v1.courses.teachers

Méthodes
create POST /v1/courses/{courseId}/teachers
Crée un enseignant pour un cours.
delete DELETE /v1/courses/{courseId}/teachers/{userId}
Supprime l'enseignant spécifié du cours spécifié.
get GET /v1/courses/{courseId}/teachers/{userId}
Renvoie un enseignant d'un cours.
list GET /v1/courses/{courseId}/teachers
Affiche la liste des enseignants de ce cours que le demandeur est autorisé à consulter.

Ressource REST: v1.courses.topics

Méthodes
create POST /v1/courses/{courseId}/topics
Crée un sujet.
delete DELETE /v1/courses/{courseId}/topics/{id}
Supprime un sujet.
get GET /v1/courses/{courseId}/topics/{id}
Renvoie un sujet.
list GET /v1/courses/{courseId}/topics
Renvoie la liste des sujets que le demandeur est autorisé à afficher.
patch PATCH /v1/courses/{courseId}/topics/{id}
Met à jour un ou plusieurs champs d'un sujet.

Ressource REST: v1.invitations

Méthodes
accept POST /v1/invitations/{id}:accept
Accepte une invitation, la supprime et ajoute l'utilisateur invité aux enseignants ou aux élèves (le cas échéant) du cours spécifié.
create POST /v1/invitations
Crée une invitation.
delete DELETE /v1/invitations/{id}
Supprime une invitation.
get GET /v1/invitations/{id}
Renvoie une invitation.
list GET /v1/invitations
Renvoie une liste des invitations que l'utilisateur à l'origine de la demande est autorisée à afficher, en fonction de celles qui correspondent à la demande.

Ressource REST: v1.registrations

Méthodes
create POST /v1/registrations
Crée un Registration, qui entraîne l'envoi des notifications feed par Classroom à la destination indiquée dans cloudPubSubTopic.
delete DELETE /v1/registrations/{registrationId}
Supprime un Registration, ce qui empêche Classroom d'envoyer des notifications pour cet Registration.

Ressource REST : v1.userProfiles

Méthodes
get GET /v1/userProfiles/{userId}
Renvoie un profil utilisateur.

Ressource REST: v1.userProfiles.guardianInvitations

Méthodes
create POST /v1/userProfiles/{guardianInvitation.studentId}/guardianInvitations
Crée une invitation au représentant légal et envoie un e-mail au représentant légal pour lui demander de confirmer qu'il s'agit du représentant de l'élève.
get GET /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
Affiche une invitation à rejoindre un représentant légal spécifique.
list GET /v1/userProfiles/{studentId}/guardianInvitations
Renvoie une liste des invitations envoyées aux représentants légaux, que l'utilisateur à l'origine de la demande est autorisée à consulter, en fonction des paramètres fournis.
patch PATCH /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
Modifie l'invitation d'un représentant légal.

Ressource REST : v1.userProfiles.guardians

Méthodes
delete DELETE /v1/userProfiles/{studentId}/guardians/{guardianId}
Supprime un représentant légal.
get GET /v1/userProfiles/{studentId}/guardians/{guardianId}
Renvoie un représentant légal spécifique.
list GET /v1/userProfiles/{studentId}/guardians
Renvoie une liste des représentants légaux que l'utilisateur à l'origine de la demande est autorisé à afficher, en fonction de ceux correspondant à la demande.