crear eventos desde una HCG (Hoja de cálculo de Google) en el Calendario de Google es una actividad que se puede lograr con los complementos de Google, pero cuando el complemento pierde su vigencia de gratuidad y quieres seguir obteniendo los beneficios de crear eventos de calendario, la única opción posible esta en programarlo tu mismo usando Google Apps script, tambien conocido como GAS por sus siglas en ingles.
el presente tema pretende abordar los fundamento de la creación de eventos, dejando para despues, taras más elaboradas, la idea pues, es que te vayas familiarizando con la creación de eventos de calendario desde una HCG (Hoja de cálculo de Google) o Google Sheets como la llaman algunos.
Requisitos:
manejar rangos de Google sheets mediante scripts y
usar el método createEvent de CalendarApp ó la aplicación de calendario 😃
si no sabes eso, no te preocupes, es realmente muy sencillo de aplicar, te dejo la documentación oficial , por si deseas después , "escarbar" un poco más: https://developers.google.com/apps-script/reference/calendar
createEvent(title, startTime, endTime, options)
a continuación vamos a comentar los parámetros a usar según este método:
title.- nos pide un titulo para el evento, en nuestro ejemplo será:Curso de hojas de calculo con Fredy, en este caso debemos cuidar que el dato sea un "string" o cadena de texto, por supuesto , com es obvio nohabrá problemas por que es una cadena de texto
startTime.- requiere una fecha-tiempo de inicio.- elegiremos 26/9/2020 13:00:00 es decir una fecha valida
endTime.-requiere una fecha-tiempo final.-será.-27/9/2020 15:00:00 igualmente una fecha
options.-lugar del evento.-me gusta La Torre Eiffel 😎.- este debe ser un objeto javascript que cumpla los parámetros avanzados que especifica la ayuda
tal como puede verse en esta imagen
si eres observador podrás apreciar que options no esta en la imagen de la HCG (Hoja de cálculo de Google), esto es debido a que decidí incluirla desde el editor de secuencia de comando de forma directa, pero se podría haber agregado una columna extra con esta información, para que mediante código se tomaran los valores de las celdas, que es precisamente lo que vamos a hacer.
Sin más , el código que hace la magia 😊
como podemos apreciar en el argumento de opciones u options estamos agregando no solo el lugar del evento, sino una breve descripción
el código termina con un mensaje de alerta que nos avisa que el evento se ha creado con éxito en Google Calendar ,así que solo tenemos que revisar 😃
por otra parte, podemos ver que en este ejemplo de prueba, se llama a un calendario existente llamado "Pruebas-script", esto es muy importante, ya que si no modificas o adaptas esa parte, se te generará un error, por que ese calendario no existe en tu App de Google Calendar, así que tienes 2 opciones
crear un calendario con ese nombre tal cual ó
modificar es linea de código por un calendario que tu tengas en la App. de Google Calendar
en mi caso, no tengo problema , por que y existe como se ve en la imagen
si el tema fue de utilidad y quieres tener una copia, para una análisis más rápido del codigo y probarlo, puedes pedirla en el video que estará saliendo próximamente:
Síguenos y suscríbete en:
function agregarNvoventoCal_Ofimatica_Emprendedores(){
var hoja = SpreadsheetApp.getActive().getSheetByName("Hoja 1");
var N_Evento = hoja.getRange("A2").getValue();Logger.log(N_Evento);
var fecha_Inicio = hoja.getRange("B2").getValue();Logger.log(fecha_Inicio);
var fecha_Fin = hoja.getRange("C2").getValue();Logger.log(fecha_Fin);
var calPruebas = CalendarApp.getCalendarsByName('aquí va el nombre de tu calendario')[0];
calPruebas.createEvent(N_Evento, fecha_Inicio, fecha_Fin, {location: 'La Torre Eiffel',description: 'script de OE'});
SpreadsheetApp.getUi().alert("calendario creado con exito!!");
}