Manejo de errores en la conversión a PDF con Apps Script
Un script de conversión sin manejo de errores falla silenciosamente. Un documento lanza un error, el script se detiene y no tienes ni idea de qué archivos se procesaron. Un buen manejo de errores registra los fallos, mantiene el lote en marcha y te notifica cuando algo requiere atención.
Envolver las conversiones en try-catch
Envuelve cada conversión de archivo individual en su propio bloque try-catch. En caso de error, registra el nombre del archivo y el mensaje de error con Logger.log(), añade el archivo a un array de errores y continúa con el siguiente. Así un documento problemático no detiene el resto del lote.
Registrar en una hoja de cálculo de Google
El resultado de Logger.log() desaparece al terminar la ejecución. Para logs persistentes, escribe filas de estado en una hoja de cálculo de Google usando SpreadsheetApp. Cada fila registra la marca de tiempo, el nombre del archivo, el éxito o el error y el mensaje de error si corresponde. Esto te da un rastro de auditoría continuo de cada conversión.
Enviar un correo con el resumen de errores
Al final de la función de lote, comprueba si el array de errores tiene entradas. Si es así, envía un correo con la lista de archivos fallidos usando MailApp.sendEmail(). Incluye el ID del archivo para que puedas encontrar e investigar el documento problemático rápidamente.
Preguntas frecuentes
¿Cuáles son los errores más comunes en la conversión a PDF con Apps Script?
Los errores más comunes son: permisos insuficientes en un archivo, límite de velocidad superado al convertir demasiados archivos demasiado rápido e IDs de archivo no válidos. Revisa el texto del mensaje de error para identificar a qué categoría pertenece.
¿Cómo reintento las conversiones fallidas?
Almacena los IDs de los archivos fallidos en una propiedad de PropertiesService o en una fila de la hoja marcada como fallida. Añade una función de reintento que lea solo los IDs fallidos e intente la conversión de nuevo, con un retraso mayor entre intentos usando Utilities.sleep().
Pruebalo ahora
Instala la extension gratuita de Chrome y empieza a convertir tus Google Docs a PDF con un solo clic.
Instalar Extensión Gratuita