Guía de inicio rápido de Google Apps Script

En las guías de inicio rápido, se explica cómo configurar y ejecutar una app que llama a una API de Google Workspace.

Las guías de inicio rápido de Google Workspace usan las bibliotecas cliente de API para manejar algunos detalles del flujo de autenticación y autorización. Te recomendamos que uses las bibliotecas cliente para tus propias apps. Antes de ejecutar la app de muestra, cada guía de inicio rápido requiere que actives la autenticación y la autorización. Si no estás familiarizado con la autenticación y la autorización para las API de Google Workspace, consulta la descripción general de autenticación y autorización.

Crear una Google Apps Script que realice solicitudes a la API de Google Classroom

Objetivos

  • Crea la secuencia de comandos.
  • Habilita la API de Google Classroom.
  • Ejecuta la muestra.

Requisitos previos

  • Una cuenta de Google for Education con Google Classroom habilitado

  • Acceso a Google Drive

Cree la secuencia de comandos

  1. Cree una nueva secuencia de comandos en script.google.com/create.
  2. Reemplaza el contenido del editor de secuencias de comandos con el siguiente código:

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. Haz clic en Guardar .
  2. Haz clic en Untitled project, escribe Quickstart y Rename.

Habilita la API de Google Classroom

  1. Abre el proyecto Apps Script.
  2. Haz clic en Editor .
  3. Junto a Servicios, haz clic en Agregar un servicio.
  4. Selecciona la API de Google Classroom y haz clic en Agregar.

Ejecutar la muestra

En el editor de Apps Script, haga clic en Ejecutar.

La primera vez que ejecutes la muestra, se te pedirá que autorices el acceso:

  1. Haz clic en Revisar permisos.
  2. Elige una cuenta.
  3. Haga clic en Permitir.

El registro de ejecución de la secuencia de comandos aparece en la parte inferior de la ventana.

Próximos pasos