Saturn Studio – Google Docs

📌 ¿Qué es este módulo?

Google Docs es un procesador de texto basado en la nube que permite crear, editar y compartir documentos en línea. Este módulo permite crear, consultar, modificar, descargar y eliminar documentos directamente desde Saturn Studio.

📚 Descripción de los comandos

📄 Create Document

Crear un nuevo documento en Google Docs.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Google Docs necesaria para crear el documento.	My Google Docs credentials
Nombre del Documento	Nombre del documento a crear.	New document
Carpeta	Carpeta de Google Drive donde se subirá el archivo.	/rocketbot
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo: {“documentId”:”1XTQB1e0vCHpeU_uIf0UXvgOounetVAiIxT046TpqIEU”,”documentName”:”Rocketbot Job Doc”,”folderName”:”rocketbot”}	{var}

📑 Get Document

Obtener un documento de Google Docs.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Google Docs necesaria para obtener el archivo.	My Google Docs credentials
Documento	Nombre del documento a consultar.	Rocketbot Document
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo: {“title”:”Rocketbot Document”,”documentId”:”1uxAEBFp2S4af4yqLqYyJVu-L02DTpVg8nT83xNgkO8k”,…}	{var}

📃 List Documents

Listar los documentos existentes en Google Docs.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Google Docs necesaria para listar los archivos.	My Google Docs credentials
Filtro	Filtro para buscar documentos.	name contains ‘Documento’ and createdTime <= ‘2024-12-02T23:59:59Z’ and trashed = false
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo: {“documents”:[{“id”:”1uxAEBFp2S4af4yqLqYyJVu-L02DTpVg8nT83xNgkO8k”,”name”:”Rocketbot Document”},…]}	{var}

✍️ Insert Text

Insertar texto en un documento de Google Docs.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Google Docs necesaria para modificar archivos.	My Google Docs credentials
ID del Documento	ID del documento donde se insertará el texto.	1CmPIRoyhCPD_-BoyoXdWnqXvBvMaduPDkDnvXSYT5ww
Índice del documento	Posición en la que se insertará el texto (1 = primera letra).	3
Contenido del documento	Texto a insertar.	Document content
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo: {“documentId”:”1uxAEBFp2S4af4yqLqYyJVu-L02DTpVg8nT83xNgkO8k”,”insertedText”:”Inserted Text”,”insertedIndex”:1}	{var}

🖼️ Insert Image

Insertar imagen en un documento.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Google Docs necesaria para insertar imágenes.	My Google Docs credentials
Documento	Nombre del documento donde se insertará la imagen.	Rocketbot Document
Índice del documento	Posición donde se insertará la imagen.	3
URL de la imagen	Enlace de la imagen a insertar.	https://example.jpg
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo: {“insertedImage”:”https://example.jpg”,”insertedIndex”:”13″}	{var}

📄 Create Document from Template

Crear documento a partir de una plantilla existente.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Google Docs necesaria para crear desde plantilla.	My Google Docs credentials
Documento	Documento plantilla a utilizar.	Rocketbot Document
Título	Título del nuevo documento.	New document
Carpeta	Carpeta en Drive donde se almacenará el archivo.	/rocketbot
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo: {“newDocumentId”:”1Un0j9Ms47nmGaQXUlmtTaw70pC4pdonulPas8fY-KDE”,”newDocumentName”:”Another Rocketbot Document”}	{var}

🔁 Replace Text

Reemplazar texto en un documento.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Google Docs necesaria para hacer reemplazos.	My Google Docs credentials
Documento	Documento donde se realizará el reemplazo.	Rocketbot Document
Texto a reemplazar	Texto que se desea reemplazar.	Text to replace
Texto de reemplazo	Texto nuevo que sustituirá al anterior.	Replacement text
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo: {“newText”:”Saturn Studio”,”replacedText”:[“AI Studio”]}	{var}

⬇️ Download Document

Descargar un documento de Google Docs.

Parámetro	Descripción	Ejemplo
Credencial	Credencial necesaria para descargar documentos.	My Google Docs credentials
ID del Documento	ID del documento que se desea descargar.	1DZ-X7zpw_aRhWCDOU8aWT0Id_ywq9Q9Gs3w_TRilAo8
Tipo	Formato del archivo: Microsoft Word, PDF, Open Document, etc.	PDF Document
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo: [{“filename”:”document.docx”,”id”:”60d02f…”,”size”:11009,”provider”:”google-docs”}]	{var}

---

🗑️ Delete Document

Eliminar un documento de Google Docs.

Parámetro	Descripción	Ejemplo
Credencial	Credencial necesaria para eliminar documentos.	My Google Docs credentials
Documento	Nombre del documento que se desea eliminar.	Rocketbot Document
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo: {“documentDeleted”:”Rocketbot Job Doc”,”folderName”:”rocketbot”}	{var}

🧪 Ejemplo de uso

• Create Document
  Crear un documento llamado “New document” en la carpeta “/rocketbot”.
• Insert Text
  Insertar contenido personalizado en una posición específica del documento.
• Replace Text
  Reemplazar palabras clave dentro del documento con nuevo contenido dinámico.
• Download Document
  Exportar un archivo como PDF para ser compartido externamente.
• Create from Template
  Duplicar un documento existente como plantilla para crear múltiples variantes.
• Delete Document
  Eliminar documentos obsoletos de Drive desde Saturn Studio.

🧩 Requisitos

1. Tener una credencial válida de Google Docs configurada en Saturn Studio.
2. Contar con acceso a los documentos y carpetas de Google Drive correspondientes.
3. Para insertar texto o imágenes, el índice debe estar dentro del rango válido del documento.