Service Classroom

gérer les cours et les listes d'élèves.

Le service Classroom vous permet d'utiliser l' API Google Classroom dans Google Apps Script. Cette API permet aux administrateurs, aux enseignants et aux élèves d'afficher et de gérer leurs cours et leurs listes d'élèves.

Il s'agit d'un service avancé qui doit être activé avant d'être utilisé. Suivez le long avec le guide de démarrage rapide pour des instructions étape par étape sur la façon de commencer.

Référence

Pour obtenir des informations détaillées sur ce service, consultez la documentation de référence de l' API Classroom. Comme tous les services avancés d'Apps Script, le service Classroom utilise les mêmes objets, méthodes et paramètres que l'API publique. Pour en savoir plus, consultez Déterminer les signatures de méthode.

Pour signaler des problèmes et obtenir de l'aide, consultez le guide d'assistance Classroom.

Exemple de code

L'exemple de code suivant utilise la version 1 de l' API.

Répertorier les cours

Cet exemple répertorie les dix premiers cours auxquels l'utilisateur a accès.

advanced/classroom.gs
/**
 * Lists 10 course names and IDs.
 */
function listCourses() {
  /**
   * @see https://developers.google.com/classroom/reference/rest/v1/courses/list
   */
  const optionalArgs = {
    pageSize: 10,
    // Use other query parameters here if needed.
  };
  try {
    const response = Classroom.Courses.list(optionalArgs);
    const courses = response.courses;
    if (!courses || courses.length === 0) {
      console.log("No courses found.");
      return;
    }
    // Print the course names and IDs of the available courses.
    for (const course in courses) {
      console.log("%s (%s)", courses[course].name, courses[course].id);
    }
  } catch (err) {
    // TODO (developer)- Handle Courses.list() exception from Classroom API
    console.log("Failed with error %s", err.message);
  }
}