google-apps-scriptEmpezando con google-apps-script


Observaciones

La descripción oficial de Google Apps Script se publica en http://www.google.com/script/start , desde allí

Google Apps Script es un lenguaje de scripts en la nube de JavaScript que proporciona formas sencillas de automatizar tareas en los productos de Google y servicios de terceros y crear aplicaciones web.

Desde https://developers.google.com/apps-script/guides/services/#basic_javascript_features

Apps Script se basa en JavaScript 1.6 , además de algunas características de 1.7 y 1.8 . Por lo tanto, muchas funciones básicas de JavaScript están disponibles además de los servicios integrados y avanzados de Google : puede usar objetos comunes como Array , Date , RegExp , etc. , así como los objetos globales de Math y Object . Sin embargo, debido a que el código de Apps Script se ejecuta en los servidores de Google (no en el lado del cliente, excepto en las páginas del servicio HTML ), las funciones basadas en el navegador como la manipulación de DOM o la API de Windows no están disponibles.

Una mirada más profunda a Google Apps Script

Google Apps Script es una plataforma como servicio basado en JavaScript que se utiliza principalmente para automatizar y ampliar Google Apps. Apps Script se ejecuta exclusivamente en la infraestructura de Google y no requiere aprovisionamiento ni configuración del servidor. Un IDE en línea sirve como interfaz para toda la plataforma que conecta todos los servicios que están disponibles para Apps Script. La autenticación del usuario se incluye en la plataforma a través de OAuth2 y no requiere ningún código o configuración por parte del autor del script.

Apps Script se ejecuta en el lado del servidor, pero puede tener interfaces de usuario creadas con HTML, CSS, JavaScript o cualquier otra tecnología compatible con el navegador. A diferencia de Nodejs, que está controlado por eventos, los scripts de aplicación se ejecutan en un modelo de subprocesos. Todas las llamadas a un script generan una instancia única de ese script que se ejecuta de forma aislada de todas las demás instancias. Cuando una instancia de un script termina su ejecución se destruye.

Las funciones en Apps Script están bloqueando, por lo que no se necesitan patrones de devolución de llamada y de programación asíncrona. El bloqueo se utiliza para evitar que las secciones críticas de código, como el archivo IO, se ejecuten simultáneamente en diferentes instancias.

En la práctica, escribir scripts de aplicaciones es simple. A continuación se muestra un sencillo script que crea una nueva hoja de cálculo a partir de una plantilla de hoja de cálculo.

// Create a new spreadsheet from a template
function createSpreadsheet(){
   var templateFileId = '1Azcz9GwCeHjGl9TXf4aUh6g20Eqmgd1UMSdNVjzIZPk';
   var sheetName = 'Account Log for:' + new Date();
   SpreadsheetApp.openById(templateFileId).copy(sheetName);   
} 
 

Hola Mundo

Vamos a saludar como un cuadro de mensaje.

function helloWorld() 
{
  Browser.msgBox("Hello World");
}
 

Para ejecutar el script, haga clic en ▶ o seleccione el elemento de menú Ejecutar -> helloWorld

Instalación o configuración

Google Apps Script no requiere instalación o instalación. El único requisito es una cuenta de Google. Una cuenta de Gmail funciona tan bien como una cuenta de Google Apps for Work / Education / Government. Puede crear una nueva cuenta de Google yendo a accounts.google.com

Comience su primer script yendo a script.google.com . También puede acceder a Google Apps Script en las tools -> Script editor... de muchas aplicaciones de Google, es decir , documentos, hojas, formularios, etc. Google Apps Script también se puede agregar directamente a su Google Drive con la función Connect more apps..

La documentación oficial se puede encontrar en developers.google.com/apps-script/ .

Para que los scripts de aplicación se ejecuten, deben contener un archivo code.gs. El archivo code.gs debe contener una función llamada doGet (secuencias de comandos independientes) o una función onOpen (secuencias de comandos adicionales). Los inicios rápidos en la documentación contienen ejemplos.

Si una api está activada en el script de aplicación, también debe estar activada en la consola de desarrolladores. Sin embargo, la consola de desarrolladores contiene api que se pueden activar pero no aparecen en la interfaz de la aplicación-script. Por ejemplo, Marketplace SDK debe estar activado en la consola de desarrolladores antes de que la aplicación pueda publicarse en Google Play Store o en una implementación de dominio de G Suite.

Para las aplicaciones de Google para educación / trabajo / gobierno, hay configuraciones en la consola de administración de dominio que se pueden ajustar para permitir o no permitir que se ejecuten los scripts de aplicación.

Ejecutando / depurando tu script

Intente ejecutar su código desde la barra de herramientas como se muestra a continuación:

introduzca la descripción de la imagen aquí

En su código, si tiene más de una función, antes de ejecutarla, debe mencionar la función con la que desea ejecutar. Por ejemplo :

introduzca la descripción de la imagen aquí

Alternativamente, puede presionar ctrl + r desde su teclado para ejecutar el código. Guardará el código primero, si no se guarda, y luego lo ejecutará. Pero, para que esto funcione, debe haber seleccionado la función, como se ve en la imagen de arriba.

Además, si algunas actividades externas invocan su script, aún podrá ver los registros haciendo clic en ver-> registros si está registrando algo después de que se ejecuta el código.

Tipos de scripts

Los scripts de Google App son de tres tipos.

  • Ser único
  • Limitado a las aplicaciones de Google
  • Aplicaciones web

Escritura independiente

Los scripts independientes no están vinculados a ninguna aplicación de Google, es decir , documentos, hojas o formularios, etc. Los scripts independientes se pueden crear visitando script.google.com o conectando el script de Google App con Google Drive. El script independiente se puede usar para programar aplicaciones de Google de forma independiente, se puede usar como una aplicación web o se puede configurar para que se ejecute automáticamente desde un disparador instalable. Consulte la documentación para el script independiente.

Limitado a las aplicaciones de Google

Script enlazado a Google Apps también conocido como script enlazado a contenedor; a diferencia de los scripts independientes, están vinculados a las aplicaciones de Google, es decir, Google Docs o Google Sheets, etc. Los scripts encuadernados en contenedores pueden crearse seleccionando tools> Script editor desde Google App. Algunas funciones, como los cuadros de diálogo, las indicaciones, los menús y la barra lateral, solo se proporcionan mediante secuencias de comandos de contenedor. Además, las secuencias de comandos de contenedor se utilizan para crear complementos de Google . Consulte la documentación para los scripts enlazados al contenedor.

Aplicaciones web

Google App Script se puede utilizar como aplicación web, ya que se puede acceder a él mediante el navegador. La aplicación web puede proporcionar una interfaz de usuario en el navegador y puede hacer uso de las aplicaciones de Google, es decir , documentos, hojas, etc. Tanto las secuencias de comandos independientes como las de Google Apps pueden convertirse en aplicaciones web. Para que cualquier script funcione como una aplicación web, el script debe cumplir con dos requisitos:

  • incluye una función doGet() o doPost() .
  • La función devuelve un objeto HTML Servicio HtmlOutput o un objeto Content Service TextOutput.

Las funciones Inshort, doGet() y doPost() funcionan como los controladores http get y post request respectivamente.

Para más detalles sobre aplicaciones web, consulte la documentación oficial.