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

Crea un script de Google Apps que realice solicitudes a la API de Google Classroom.

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. En esta guía de inicio rápido, se usa un enfoque de autenticación simplificado que es adecuado para un entorno de pruebas. Para un entorno de producción, te recomendamos que obtengas información sobre la autenticación y la autorización antes de elegir las credenciales de acceso adecuadas para tu app.

En Apps Script, los inicios rápidos de Google Workspace usan los servicios avanzados de Google para llamar a las APIs de Google Workspace y controlar algunos detalles del flujo de autenticación y autorización.

Objetivos

  • Configurar el entorno
  • Crea y configura la secuencia de comandos.
  • Ejecuta la secuencia de comandos.

Requisitos previos

  • Una cuenta de Google for Education con Google Classroom habilitado

  • Acceso a Google Drive

Crea la secuencia de comandos

  1. Crea una secuencia de comandos nueva en script.google.com/create.
  2. Reemplaza el contenido del editor de secuencias de comandos por 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 Proyecto sin título, escribe Quickstart y haz clic en Cambiar nombre.

Configura la secuencia de comandos

Habilita la API de Google Classroom

Abre el proyecto de Apps Script.

  1. Haz clic en Editor .
  2. Junto a Servicios, haz clic en Agregar un servicio .
  3. Selecciona la API de Google Classroom y haz clic en Agregar.

Ejecuta la muestra

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

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

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

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

Próximos pasos

Anterior
Go
Siguiente
Java