Service Classroom

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

Référence

Pour en savoir plus sur ce service, consultez la documentation de référence de l'API Google 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 ci-dessous 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
/**
 * 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);
  }
}