Guide de démarrage rapide de Google Apps Script

Les guides de démarrage rapide expliquent comment configurer et exécuter une application qui appelle un API Google Workspace.

Les guides de démarrage rapide de Google Workspace utilisent les bibliothèques clientes des API pour gérer certaines les détails du flux d'authentification et d'autorisation. Nous vous recommandons vous utilisez les bibliothèques clientes pour vos propres applications. Ce guide de démarrage rapide utilise d'authentification simplifiée, adaptée à un test environnement. Pour un environnement de production, nous vous recommandons de vous familiariser authentification et autorisation avant Choisir les identifiants d'accès adaptés à votre application.

Créez un Google Apps Script qui envoie des requêtes à l'API Google Classroom.

Objectifs

  • Configurer l'environnement
  • Créez et configurez le script.
  • Exécutez le script.

Prérequis

  • disposer d'un compte Google for Education dans lequel Google Classroom est activé ;

  • Accès à Google Drive

Créer le script

  1. Accédez à la page script.google.com/create pour créer un script.
  2. Remplacez le contenu de l'éditeur de scripts par le code suivant:

classroom/quickstart/quickstart.gs
/**
 * Lists 10 course names and ids.
 */
function listCourses() {
  /**  here pass pageSize Query parameter as argument to get maximum number of result
   * @see https://developers.google.com/classroom/reference/rest/v1/courses/list
   */
  const optionalArgs = {
    pageSize: 10
    // Use other parameter here if needed
  };
  try {
    // call courses.list() method to list the courses in classroom
    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 courses
    for (const course of courses) {
      console.log('%s (%s)', course.name, course.id);
    }
  } catch (err) {
    // TODO (developer)- Handle Courses.list() exception from Classroom API
    // get errors like PERMISSION_DENIED/INVALID_ARGUMENT/NOT_FOUND
    console.log('Failed with error %s', err.message);
  }
}

  1. Cliquez sur Enregistrer .
  2. Cliquez sur Projet sans titre, puis saisissez Guide de démarrage rapide, puis cliquez sur Renommer.

Configurer le script

Activer l'API Google Classroom

  1. Ouvrez le projet Apps Script.
  1. Cliquez sur Éditeur .
  2. À côté de Services, cliquez sur "Ajouter un service".
  3. Sélectionner API Google Classroom puis cliquez sur Ajouter.

Exécuter l'exemple

Dans l'éditeur Apps Script, cliquez sur Exécuter.

La première fois que vous exécutez l'exemple, vous êtes invité à autoriser l'accès:

  1. Cliquez sur Examiner les autorisations.
  2. Choisissez un compte.
  3. Cliquez sur Autoriser.

Le journal d'exécution du script s'affiche en bas de la fenêtre.

<ph type="x-smartling-placeholder">

Étapes suivantes