Cómo impulsar sus aplicaciones de Google con el editor de scripts

Guía de secuencia de comandos de Google Apps

Si usa Google Apps, es probable que no las esté usando por completo. Con Google Apps Script, puede agregar menús y cuadros de diálogo personalizados, escribir funciones y macros personalizadas y crear complementos para ampliar Documentos, Hojas de cálculo y Presentaciones de Google.

¿Qué es Google Apps Script?

Google Apps Script es una plataforma de desarrollo basada en la nube para crear aplicaciones web ligeras y personalizadas. Puede crear aplicaciones escalables directamente en su navegador que se integran a la perfección con los productos de Google.

Apps Script utiliza el lenguaje JavaScript y reúne la familiaridad del desarrollo web y los productos de Google en un solo lugar, lo que lo convierte en una herramienta perfecta para personalizar aplicaciones para su negocio, organización o simplemente automatizar tareas mundanas.

Puede crear dos tipos de secuencias de comandos con Google Apps Script:

  • Autónomo: Estos scripts no están vinculados a ningún servicio, como Google Docs, Sheets o Slides. Pueden realizar funciones en todo el sistema, al igual que las macros. No son ideales para compartir con una audiencia más grande, ya que debes copiar y pegar el código para usarlos. Por ejemplo, buscar en Drive archivos con nombres específicos o ver quién tiene acceso a sus archivos y carpetas compartidos en Drive.
  • Saltar: Estos están vinculados a un archivo de Documentos, Hojas de cálculo, Formularios o Presentaciones de Google. Los scripts vinculados amplían la funcionalidad de un archivo y realizan acciones solo dentro de ese archivo específico. Los ejemplos incluyen agregar menús personalizados, cuadros de diálogo y barras laterales a un servicio o secuencia de comandos que le envía notificaciones por correo electrónico cada vez que se cambia una celda en particular en una hoja.

Si no sabe mucho sobre JavaScript, o tal vez nunca ha oído hablar de él, no se desanime por desarrollar su propio script. Es muy fácil comenzar a usar Apps Script porque proporciona una rica documentación y ejemplos depende de usted probarlo usted mismo. A continuación, se muestran algunos ejemplos sencillos que le ayudarán a comprender cómo funcionan.

Cómo crear una secuencia de comandos independiente

Ahora que sabe cuáles son, creemos su primer script independiente. Usaremos código de muestra de Google para comenzar y brindaremos explicaciones de línea de código si no está familiarizado con GoogleScript o JavaScript.

Dirigirse a Secuencia de comandos de Google Apps. En la esquina superior izquierda, haga clic en el icono de hamburguesa, luego haga clic en «Nuevo script».

Se abre un proyecto nuevo sin título con una función en blanco adentro, pero como estamos usando código de muestra de Google, puede continuar y eliminar todo el texto en el archivo.

Tu primera función de Apps Script

Notar: Debe iniciar sesión en su cuenta de Google para que este script funcione.

Después de eliminar el código precargado del archivo, pegue el siguiente código:

//Initialize your function
 function createADocument() {
 
// Create a new Google Doc named 'Hello, world!'
 var doc = DocumentApp.create('Hello, world!');
 
// Access the body of the document, then add a paragraph.
 doc.getBody().appendParagraph('This document was created by Google Apps Script.');
 }

Antes de poder ejecutar el código, debe guardar el script. Haga clic en «Archivo», luego en «Guardar».

haga clic en Archivo, luego en Guardar para guardar su secuencia de comandos

Cambie el nombre del proyecto a algo que le ayude a recordar lo que está haciendo el guión, luego presione «Aceptar».

Cambie el nombre de su proyecto a algo que le indique lo que está haciendo el script, luego haga clic en Aceptar

Para ejecutar su código, haga clic en el icono de reproducción ubicado en la barra de herramientas.

Deberá otorgar al script ciertos permisos para acceder a su cuenta de Google a través de una ventana emergente después de hacer clic en «Ejecutar» por primera vez. Haga clic en «Revisar permisos» para ver a qué necesita acceder.

Antes de que se pueda ejecutar el script, debe verificar los permisos que necesita.  Haga clic en Verificar permisos

Dado que esta no es una aplicación verificada por Google, recibirá otra advertencia. Básicamente dice que, a menos que conozca al desarrollador (nosotros), solo proceda si confía en él. Haga clic en «Avanzado», luego en «Ir a CreateNewDoc» (o el nombre que le dio a este script).

Aparece una advertencia de Google que indica que la aplicación que está ejecutando no está verificada por ellos.  Haga clic en avanzado, luego en Ir a CreateNewDoc

Revise los permisos requeridos por la secuencia de comandos, luego haga clic en «Permitir».

Verifique los permisos, luego haga clic en Permitir

¡Excelente! Ahora dirígete a tu Drive y, si todo ha ido bien, aparecerá el mensaje «¡Hola, mundo!» el archivo debería estar ahí. Haga doble clic en él para abrirlo.

Vaya a su unidad y haga doble clic en el archivo recién creado

Cuando abra el archivo, verá la línea de texto del código agregada a su documento.

Dentro del archivo está la línea de texto que agregó a través del script.

Ahora, si desea recibir una notificación por correo electrónico cuando se cree el documento, puede agregar algunas líneas más de código para enviar una automáticamente a su cuenta de Google. Agregue las siguientes líneas de código después doc.getBody().appendParagraph('This document was created by Google Apps Script.'); pero antes del ultimo abrazo } :

// Get the URL of the document.
var url = doc.getUrl();
// Get the email address of the active user - that's you.
var email = Session.getActiveUser().getEmail();

// Get the name of the document to use as an email subject line.
var subject = doc.getName();

// Append a new string to the "url" variable to use as an email body.
var body = 'Link to your doc: ' + url;

// Send yourself an email with a link to the document.
GmailApp.sendEmail(email, subject, body);

Haga clic en el icono «Ejecutar».

Dado que ha agregado algunas líneas más que requieren permisos adicionales, debe seguir el mismo proceso que antes. Haga clic en «Revisar permisos».

Antes de que se pueda ejecutar el script, debe verificar los permisos que necesita.  Haga clic en Verificar permisos

Haga clic en «Avanzado», luego en «Ir a CreateNewDoc».

Notar: Como Google le notifica cuando inicia aplicaciones no verificadas, también recibirá una alerta de seguridad por correo electrónico notificándole. Google hace esto en caso de que usted no sea el que otorgue acceso a una aplicación no verificada.

Revise el nuevo conjunto de permisos requeridos por la secuencia de comandos y haga clic en «Permitir».

Verifique la nueva autorización y haga clic en Autorizar

Cuando se crea el documento, recibe un correo electrónico con un enlace al archivo en su Google Drive.

La notificación por correo electrónico que se envía automáticamente desde el script contiene un enlace al nuevo documento

Al hacer clic en el enlace, lo llevará directamente al archivo, que se encuentra en su Google Drive.

Dentro del archivo está la línea de texto agregada desde el script

Cómo crear un script vinculado

Para el siguiente ejemplo, creemos un script vinculado para Hojas de cálculo de Google que escanea una hoja existente en busca de entradas duplicadas en una fila y luego las elimina.

Si lo recuerda de antes, los scripts vinculados funcionan como un complemento para archivos específicos. Para crear una, abramos una hoja de cálculo de Google Sheet existente que tenga al menos un punto de datos duplicado.

Una hoja de Google con filas duplicadas

Haga clic en «Herramientas» y luego en «Editor de secuencias de comandos».

Haga clic en Herramientas, luego en Editor de secuencias de comandos

Google Apps Script se abre en una nueva pestaña con un script vacío. Esta vez, sin embargo, el guión está vinculado a la hoja desde la que se abre.

Una función vacía para su secuencia de comandos vinculada

Como antes, elimine la función vacía y pegue el siguiente código:

//Removes duplicate rows from the current sheet.

 function removeDuplicates() {
//Get current active Spreadsheet
 var sheet = SpreadsheetApp.getActiveSheet();
//Get all values from the spreadsheet's rows
 var data = sheet.getDataRange().getValues();
//Create an array for non-duplicates
 var newData = [];
//Iterate through a row's cells
 for (var i in data) {
   var row = data[i];
   var duplicate = false;
   for (var j in newData) {
    if (row.join() == newData[j].join()) {
     duplicate = true;
    }
  }
//If not a duplicate, put in newData array
 if (!duplicate) {
  newData.push(row);
 }
}
//Delete the old Sheet and insert the newData array
 sheet.clearContents();
 sheet.getRange(1, 1, newData.length, newData[0].length).setValues(newData);
}

Notar: Para que el script elimine un duplicado, todas las celdas de la fila deben coincidir.

Guarde y cambie el nombre de su secuencia de comandos, luego toque el icono «Ejecutar».

Nuevamente, como encontró en el último script que creó, deberá revisar los permisos requeridos por su script y otorgarle acceso a su hoja de cálculo. Haga clic en «Examinar permisos» para ver qué acceso desea este script.

Haga clic en Verificar permisos para mostrar los permisos solicitados

Acepte las indicaciones y haga clic en «Permitir» para autorizar el script.

Verifique los permisos, luego haga clic en Permitir

Cuando se complete la ejecución, regrese a su hoja y, como por arte de magia, ¡todas las entradas duplicadas desaparecerán de su archivo!

Se han eliminado los puntos de datos duplicados.

Desafortunadamente, si sus datos están dentro de una matriz, como en el ejemplo anterior, este script no cambiará el tamaño de la matriz para acomodar la cantidad de entradas que contiene.

Si bien estos son dos ejemplos bastante sencillos del uso de Apps Script, las opciones son casi infinitas y todo depende de lo que pueda imaginar con esos recursos. Pero, mientras tanto, dirígete al Página de Github de desarrolladores de GSuite Dónde Inspiración digital y consulte la pila de scripts de muestra que puede implementar en sus propios departamentos para tener una mejor idea de lo que Apps Script es realmente capaz de hacer.

Publicaciones Similares

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *