Service Classroom

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 de consulter 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 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 dans 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

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