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

En los 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 la API para controlar algunos detalles del flujo de autenticación y autorización. Te recomendamos que uses las bibliotecas cliente para tus propias apps. En esta guía de inicio rápido, se usa un enfoque de autenticación simplificado que es adecuado para un entorno de prueba. En el caso de un entorno de producción, te recomendamos que aprendas sobre la autenticación y autorización antes de elegir las credenciales de acceso adecuadas para tu app.

Crea una secuencia de comandos de Google Apps que realice solicitudes a la API de Calendario de Google.

Objetivos

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

Requisitos previos

  • Una Cuenta de Google con el Calendario de Google habilitado

  • Acceso a Google Drive

Crea la secuencia de comandos

  1. Para crear una secuencia de comandos nueva, ve a script.google.com/create.
  2. Reemplaza el contenido del editor de secuencia de comandos por el siguiente código:

calendar/quickstart/quickstart.gs
/**
 * Lists 10 upcoming events in the user's calendar.
 * @see https://developers.google.com/calendar/api/v3/reference/events/list
 */
function listUpcomingEvents() {
  const calendarId = 'primary';
  // Add query parameters in optionalArgs
  const optionalArgs = {
    timeMin: (new Date()).toISOString(),
    showDeleted: false,
    singleEvents: true,
    maxResults: 10,
    orderBy: 'startTime'
    // use other optional query parameter here as needed.
  };
  try {
    // call Events.list method to list the calendar events using calendarId optional query parameter
    const response = Calendar.Events.list(calendarId, optionalArgs);
    const events = response.items;
    if (events.length === 0) {
      console.log('No upcoming events found');
      return;
    }
    // Print the calendar events
    for (const event of events) {
      let when = event.start.dateTime;
      if (!when) {
        when = event.start.date;
      }
      console.log('%s (%s)', event.summary, when);
    }
  } catch (err) {
    // TODO (developer) - Handle exception from Calendar API
    console.log('Failed with error %s', err.message);
  }
}

  1. Haz clic en Guardar .
  2. Haz clic en Proyecto sin título, escribe Guía de inicio rápido y haz clic en Cambiar nombre.

Configura la secuencia de comandos

Habilita la API de Calendario de Google

  1. 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 Calendario 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