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 d'élèves.

Reference

Pour plus d'informations sur ce service, consultez la documentation de référence sur 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 la section Comment les signatures de méthode sont-elles déterminées ?

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