Google Sheets

Leer, escribir y actualizar datos

go

Google Sheets es una potente aplicación de hojas de cálculo basada en la nube que permite a los usuarios crear, editar y colaborar en hojas de cálculo en tiempo real. Como parte del conjunto de productividad de Google, Google Sheets ofrece una plataforma versátil para la organización, análisis y visualización de datos con sólidas capacidades de formato, fórmulas y opciones para compartir.

Aprende cómo integrar la herramienta "Leer" de Google Sheets en Sim para obtener datos de tus hojas de cálculo sin esfuerzo e integrarlos en tus flujos de trabajo. Este tutorial te guía a través de la conexión con Google Sheets, la configuración de lecturas de datos y el uso de esa información para automatizar procesos en tiempo real. Perfecto para sincronizar datos en vivo con tus agentes.

Descubre cómo usar la herramienta "Escribir" de Google Sheets en Sim para enviar automáticamente datos desde tus flujos de trabajo a tus hojas de cálculo de Google. Este tutorial cubre la configuración de la integración, la configuración de operaciones de escritura y la actualización de tus hojas sin problemas a medida que se ejecutan los flujos de trabajo. Perfecto para mantener registros en tiempo real sin entrada manual.

Explora cómo aprovechar la herramienta "Actualizar" de Google Sheets en Sim para modificar entradas existentes en tus hojas de cálculo basadas en la ejecución del flujo de trabajo. Este tutorial demuestra cómo configurar la lógica de actualización, mapear campos de datos y sincronizar cambios instantáneamente. Perfecto para mantener tus datos actualizados y consistentes.

Aprende a usar la herramienta "Añadir" de Google Sheets en Sim para agregar sin esfuerzo nuevas filas de datos a tus hojas de cálculo durante la ejecución del flujo de trabajo. Este tutorial te guía a través de la configuración de la integración, la configuración de acciones de añadir y asegurando un crecimiento fluido de datos. ¡Perfecto para expandir registros sin esfuerzo manual!

Con Google Sheets, puedes:

  • Crear y editar hojas de cálculo: Desarrolla documentos basados en datos con opciones completas de formato y cálculo
  • Colaborar en tiempo real: Trabaja simultáneamente con múltiples usuarios en la misma hoja de cálculo
  • Analizar datos: Usa fórmulas, funciones y tablas dinámicas para procesar y entender tus datos
  • Visualizar información: Crea gráficos, diagramas y formato condicional para representar datos visualmente
  • Acceder desde cualquier lugar: Usa Google Sheets en diferentes dispositivos con sincronización automática en la nube
  • Trabajar sin conexión: Continúa trabajando sin conexión a internet con cambios que se sincronizan cuando vuelves a estar en línea
  • Integrar con otros servicios: Conéctate con Google Drive, Forms y aplicaciones de terceros

En Sim, la integración con Google Sheets permite a tus agentes interactuar directamente con datos de hojas de cálculo de forma programática. Esto permite potentes escenarios de automatización como extracción de datos, análisis, informes y gestión. Tus agentes pueden leer hojas de cálculo existentes para extraer información, escribir en hojas de cálculo para actualizar datos y crear nuevas hojas de cálculo desde cero. Esta integración cierra la brecha entre tus flujos de trabajo de IA y la gestión de datos, permitiendo una interacción fluida con datos estructurados. Al conectar Sim con Google Sheets, puedes automatizar flujos de trabajo de datos, generar informes, extraer información de los datos y mantener información actualizada - todo a través de tus agentes inteligentes. La integración admite varios formatos de datos y especificaciones de rangos, haciéndola lo suficientemente flexible para manejar diversas necesidades de gestión de datos mientras mantiene la naturaleza colaborativa y accesible de Google Sheets.

Instrucciones de uso

Integra Google Sheets en el flujo de trabajo. Puede leer, escribir, añadir y actualizar datos. Requiere OAuth.

Herramientas

google_sheets_read

Leer datos de una hoja de cálculo de Google Sheets

Entrada

ParámetroTipoObligatorioDescripción
spreadsheetIdstringEl ID de la hoja de cálculo (se encuentra en la URL: docs.google.com/spreadsheets/d/{SPREADSHEET_ID}/edit).
rangestringNoEl rango en notación A1 para leer (por ejemplo, "Sheet1!A1:D10", "A1:B5"). Si no se especifica, por defecto es la primera hoja A1:Z1000.

Salida

ParámetroTipoDescripción
datajsonDatos de la hoja incluyendo rango y valores de celdas
metadatajsonMetadatos de la hoja de cálculo incluyendo ID y URL

google_sheets_write

Escribir datos en una hoja de cálculo de Google Sheets

Entrada

ParámetroTipoObligatorioDescripción
spreadsheetIdstringEl ID de la hoja de cálculo
rangestringNoEl rango en notación A1 donde escribir (por ejemplo, "Sheet1!A1:D10", "A1:B5")
valuesarrayLos datos a escribir como un array 2D (por ejemplo, [["Nombre", "Edad"], ["Alice", 30], ["Bob", 25]]) o array de objetos.
valueInputOptionstringNoEl formato de los datos a escribir
includeValuesInResponsebooleanNoSi se deben incluir los valores escritos en la respuesta

Salida

ParámetroTipoDescripción
updatedRangestringRango de celdas que fueron actualizadas
updatedRowsnumberNúmero de filas actualizadas
updatedColumnsnumberNúmero de columnas actualizadas
updatedCellsnumberNúmero de celdas actualizadas
metadatajsonMetadatos de la hoja de cálculo incluyendo ID y URL

google_sheets_update

Actualizar datos en una hoja de cálculo de Google Sheets

Entrada

ParámetroTipoObligatorioDescripción
spreadsheetIdstringEl ID de la hoja de cálculo a actualizar
rangestringNoEl rango en notación A1 para actualizar (por ejemplo, "Sheet1!A1:D10", "A1:B5")
valuesarrayLos datos para actualizar como un array 2D (por ejemplo, [["Nombre", "Edad"], ["Alice", 30]]) o array de objetos.
valueInputOptionstringNoEl formato de los datos a actualizar
includeValuesInResponsebooleanNoSi se deben incluir los valores actualizados en la respuesta

Salida

ParámetroTipoDescripción
updatedRangestringRango de celdas que fueron actualizadas
updatedRowsnumberNúmero de filas actualizadas
updatedColumnsnumberNúmero de columnas actualizadas
updatedCellsnumberNúmero de celdas actualizadas
metadatajsonMetadatos de la hoja de cálculo incluyendo ID y URL

google_sheets_append

Añadir datos al final de una hoja de cálculo de Google Sheets

Entrada

ParámetroTipoObligatorioDescripción
spreadsheetIdstringEl ID de la hoja de cálculo a la que añadir datos
rangestringNoEl rango en notación A1 después del cual añadir datos (ej. "Hoja1", "Hoja1!A:D")
valuesarrayLos datos a añadir como un array 2D (ej. [["Alice", 30], ["Bob", 25]]) o array de objetos.
valueInputOptionstringNoEl formato de los datos a añadir
insertDataOptionstringNoCómo insertar los datos (OVERWRITE o INSERT_ROWS)
includeValuesInResponsebooleanNoSi se deben incluir los valores añadidos en la respuesta

Salida

ParámetroTipoDescripción
tableRangestringRango de la tabla donde se añadieron los datos
updatedRangestringRango de celdas que fueron actualizadas
updatedRowsnumberNúmero de filas actualizadas
updatedColumnsnumberNúmero de columnas actualizadas
updatedCellsnumberNúmero de celdas actualizadas
metadatajsonMetadatos de la hoja de cálculo incluyendo ID y URL

Notas

  • Categoría: tools
  • Tipo: google_sheets
ParámetroTipoRequeridoDescripción
spreadsheetIdstringID de la hoja de cálculo de Google Sheets
includeGridDatabooleanNoSi se deben incluir datos de cuadrícula (valores de celdas). Por defecto es false.

Salida

ParámetroTipoDescripción
spreadsheetIdstringEl ID de la hoja de cálculo
titlestringEl título de la hoja de cálculo
localestringLa configuración regional de la hoja de cálculo
timeZonestringLa zona horaria de la hoja de cálculo
spreadsheetUrlstringURL de la hoja de cálculo
sheetsarrayLista de hojas en la hoja de cálculo
sheetIdnumberEl ID de la hoja
titlestringEl título/nombre de la hoja
indexnumberEl índice de la hoja (posición)
rowCountnumberNúmero de filas en la hoja
columnCountnumberNúmero de columnas en la hoja
hiddenbooleanSi la hoja está oculta

google_sheets_create_spreadsheet

Crear una nueva hoja de cálculo de Google Sheets

Entrada

ParámetroTipoRequeridoDescripción
titlestringEl título de la nueva hoja de cálculo
sheetTitlesjsonNoArray de nombres de hojas a crear (ej., ["Hoja1", "Datos", "Resumen"]). Por defecto es una sola "Hoja1".
localestringNoLa configuración regional de la hoja de cálculo (ej., "es_ES")
timeZonestringNoLa zona horaria de la hoja de cálculo (ej., "Europe/Madrid")

Salida

ParámetroTipoDescripción
spreadsheetIdstringEl ID de la hoja de cálculo creada
titlestringEl título de la hoja de cálculo creada
spreadsheetUrlstringURL de la hoja de cálculo creada
sheetsarrayLista de hojas creadas en la hoja de cálculo
sheetIdnumberEl ID de la hoja
titlestringEl título/nombre de la hoja
indexnumberEl índice de la hoja (posición)

google_sheets_batch_get

Lee múltiples rangos de una hoja de cálculo de Google Sheets en una sola solicitud

Entrada

ParámetroTipoRequeridoDescripción
spreadsheetIdstringID de la hoja de cálculo de Google Sheets
rangesjsonArray de rangos a leer (ej., ["Hoja1!A1:D10", "Hoja2!A1:B5"]). Cada rango debe incluir el nombre de la hoja.
majorDimensionstringNoLa dimensión principal de los valores: "ROWS" (predeterminado) o "COLUMNS"
valueRenderOptionstringNoCómo deben renderizarse los valores: "FORMATTED_VALUE" (predeterminado), "UNFORMATTED_VALUE" o "FORMULA"

Salida

ParámetroTipoDescripción
spreadsheetIdstringEl ID de la hoja de cálculo
valueRangesarrayArray de rangos de valores leídos de la hoja de cálculo
rangestringEl rango que fue leído
majorDimensionstringDimensión principal (ROWS o COLUMNS)
valuesarrayLos valores de las celdas como un array 2D
metadatajsonMetadatos de la hoja de cálculo incluyendo ID y URL
spreadsheetIdstringID de la hoja de cálculo de Google Sheets
spreadsheetUrlstringURL de la hoja de cálculo

google_sheets_batch_update

Actualiza múltiples rangos en una hoja de cálculo de Google Sheets en una sola solicitud

Entrada

ParámetroTipoRequeridoDescripción
spreadsheetIdstringID de la hoja de cálculo de Google Sheets
datajsonArray de rangos de valores a actualizar. Cada elemento debe tener "range" (ej., "Sheet1!A1:D10") y "values" (array 2D).
valueInputOptionstringNoCómo deben interpretarse los datos de entrada: "RAW" o "USER_ENTERED" (predeterminado). USER_ENTERED analiza fórmulas.

Salida

ParámetroTipoDescripción
spreadsheetIdstringEl ID de la hoja de cálculo
totalUpdatedRowsnumberNúmero total de filas actualizadas
totalUpdatedColumnsnumberNúmero total de columnas actualizadas
totalUpdatedCellsnumberNúmero total de celdas actualizadas
totalUpdatedSheetsnumberNúmero total de hojas actualizadas
responsesarrayArray de respuestas de actualización para cada rango
spreadsheetIdstringEl ID de la hoja de cálculo
updatedRangestringEl rango que fue actualizado
updatedRowsnumberNúmero de filas actualizadas en este rango
updatedColumnsnumberNúmero de columnas actualizadas en este rango
updatedCellsnumberNúmero de celdas actualizadas en este rango
metadatajsonMetadatos de la hoja de cálculo incluyendo ID y URL
spreadsheetIdstringID de la hoja de cálculo de Google Sheets
spreadsheetUrlstringURL de la hoja de cálculo

google_sheets_batch_clear

Borrar múltiples rangos en una hoja de cálculo de Google Sheets en una sola solicitud

Entrada

ParámetroTipoRequeridoDescripción
spreadsheetIdstringID de la hoja de cálculo de Google Sheets
rangesjsonArray de rangos a borrar (ej., ["Hoja1!A1:D10", "Hoja2!A1:B5"]). Cada rango debe incluir el nombre de la hoja.

Salida

ParámetroTipoDescripción
spreadsheetIdstringEl ID de la hoja de cálculo
clearedRangesarrayArray de rangos que fueron borrados
metadatajsonMetadatos de la hoja de cálculo incluyendo ID y URL
spreadsheetIdstringID de la hoja de cálculo de Google Sheets
spreadsheetUrlstringURL de la hoja de cálculo

google_sheets_copy_sheet

Copiar una hoja de una hoja de cálculo a otra

Entrada

ParámetroTipoRequeridoDescripción
sourceSpreadsheetIdstringID de la hoja de cálculo de Google Sheets de origen
sheetIdnumberEl ID de la hoja a copiar (ID numérico, no el nombre de la hoja). Usa Obtener hoja de cálculo para encontrar los ID de las hojas.
destinationSpreadsheetIdstringEl ID de la hoja de cálculo de destino donde se copiará la hoja

Salida

ParámetroTipoDescripción
sheetIdnumberEl ID de la hoja recién creada en el destino
titlestringEl título de la hoja copiada
indexnumberEl índice (posición) de la hoja copiada
sheetTypestringEl tipo de la hoja (GRID, CHART, etc.)
destinationSpreadsheetIdstringEl ID de la hoja de cálculo de destino
destinationSpreadsheetUrlstringURL a la hoja de cálculo de destino

On this page

Start building today
Trusted by over 100,000 builders.
The open-source platform to build AI agents and run your agentic workforce.
Get started