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 una API de Google Workspace.

Las guías de inicio rápido de Google Workspace usan las bibliotecas cliente de la API para manejar 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 apropiado para un entorno de pruebas. En el caso de un entorno de producción, te recomendamos obtener información sobre autenticación y autorización antes de elegir las credenciales de acceso adecuadas para tu app.

Crear una secuencia de comandos de Google Apps Script que realice solicitudes a la API de Gmail

Objetivos

  • Crea la secuencia de comandos.
  • Habilitar la API de Gmail
  • Ejecuta la muestra.

Requisitos previos

  • Una Cuenta de Google con Gmail habilitado

  • Acceso a Google Drive

Crea la secuencia de comandos

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

gmail/quickstart/quickstart.gs
/**
 * Lists all labels in the user's mailbox
 * @see https://developers.google.com/gmail/api/reference/rest/v1/users.labels/list
 */
function listLabels() {
  try {
    // Gmail.Users.Labels.list() API returns the list of all Labels in user's mailbox
    const response = Gmail.Users.Labels.list('me');
    if (!response || response.labels.length === 0) {
      // TODO (developer) - No labels are returned from the response
      console.log('No labels found.');
      return;
    }
    // Print the Labels that are available.
    console.log('Labels:');
    for (const label of response.labels ) {
      console.log('- %s', label.name);
    }
  } catch (err) {
    // TODO (developer) - Handle exception on Labels.list() API
    console.log('Labels.list() API failed with error %s', err.toString());
  }
}

  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 de Gmail

  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 Gmail y haz clic en Agregar.

Ejecutar 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 aparecerá en la parte inferior de la ventana.

Próximos pasos