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.

Il s'agit d'un service avancé qui doit être activé avant utilisation. Suivez le guide de démarrage rapide pour obtenir des instructions détaillées sur la façon de commencer.

Référence

Pour en savoir plus 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.

Lister les cours

Cet exemple liste les dix premiers cours auxquels l'utilisateur a accès.

advanced/classroom.gs

Afficher sur GitHub

/**
 * 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);
  }
}