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

Las guías de inicio rápido explican cómo configurar y ejecutar una app que llama a un API de Google Workspace.

Las guías de inicio rápido de Google Workspace usan las bibliotecas cliente de la API para controlar algunas los detalles del flujo de autenticación y autorización. Te recomendamos lo siguiente: usas las bibliotecas cliente para tus propias apps. En esta guía de inicio rápido, se usa un de autenticación simplificado, adecuado para realizar pruebas en un entorno de nube. Para un entorno de producción, recomendamos conocer autenticación y autorización antes de elige las credenciales de acceso que sean adecuados para tu app.

Crea un Google Apps Script que realiza solicitudes a la API del Calendario de Google.

Objetivos

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

Requisitos previos

  • Una Cuenta de Google con el Calendario de Google habilitado

  • Acceso a Google Drive

Crea la secuencia de comandos

  1. Crea una nueva secuencia de comandos desde script.google.com/create.
  2. Reemplaza el contenido del editor de secuencia de comandos con 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.

Habilita la API del Calendario de Google

  1. Abre el proyecto Apps Script.
  2. Haz clic en Editor .
  3. Junto a Servicios, haz clic en Agregar un servicio.
  4. Seleccionar API de Calendar 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