---
title: Google Sheets
description: Leer, escribir y actualizar datos
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="google_sheets"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Google Sheets](https://sheets.google.com) 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.

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/xxP7MZRuq_0"
  title="Usa la herramienta Leer de Google Sheets en Sim"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

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.

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/cO86qTj7qeY"
  title="Usa la herramienta Escribir de Google Sheets en Sim"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

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.

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/95by2fL9yn4"
  title="Usa la herramienta de actualización de Google Sheets en Sim"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

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!

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/8DgNvLBCsAo"
  title="Usa la herramienta Añadir de Google Sheets en Sim"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

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.
{/* MANUAL-CONTENT-END */}

## 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ámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Sí | El ID de la hoja de cálculo \(se encuentra en la URL: docs.google.com/spreadsheets/d/\{SPREADSHEET_ID\}/edit\). |
| `range` | string | No | El 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ámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `data` | json | Datos de la hoja incluyendo rango y valores de celdas |
| `metadata` | json | Metadatos 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ámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Sí | El ID de la hoja de cálculo |
| `range` | string | No | El rango en notación A1 donde escribir \(por ejemplo, "Sheet1!A1:D10", "A1:B5"\) |
| `values` | array | Sí | Los datos a escribir como un array 2D \(por ejemplo, \[\["Nombre", "Edad"\], \["Alice", 30\], \["Bob", 25\]\]\) o array de objetos. |
| `valueInputOption` | string | No | El formato de los datos a escribir |
| `includeValuesInResponse` | boolean | No | Si se deben incluir los valores escritos en la respuesta |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `updatedRange` | string | Rango de celdas que fueron actualizadas |
| `updatedRows` | number | Número de filas actualizadas |
| `updatedColumns` | number | Número de columnas actualizadas |
| `updatedCells` | number | Número de celdas actualizadas |
| `metadata` | json | Metadatos 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ámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Sí | El ID de la hoja de cálculo a actualizar |
| `range` | string | No | El rango en notación A1 para actualizar \(por ejemplo, "Sheet1!A1:D10", "A1:B5"\) |
| `values` | array | Sí | Los datos para actualizar como un array 2D \(por ejemplo, \[\["Nombre", "Edad"\], \["Alice", 30\]\]\) o array de objetos. |
| `valueInputOption` | string | No | El formato de los datos a actualizar |
| `includeValuesInResponse` | boolean | No | Si se deben incluir los valores actualizados en la respuesta |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `updatedRange` | string | Rango de celdas que fueron actualizadas |
| `updatedRows` | number | Número de filas actualizadas |
| `updatedColumns` | number | Número de columnas actualizadas |
| `updatedCells` | number | Número de celdas actualizadas |
| `metadata` | json | Metadatos 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ámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `spreadsheetId` | string | Sí | El ID de la hoja de cálculo a la que añadir datos |
| `range` | string | No | El rango en notación A1 después del cual añadir datos (ej. "Hoja1", "Hoja1!A:D") |
| `values` | array | Sí | Los datos a añadir como un array 2D (ej. [["Alice", 30], ["Bob", 25]]) o array de objetos. |
| `valueInputOption` | string | No | El formato de los datos a añadir |
| `insertDataOption` | string | No | Cómo insertar los datos (OVERWRITE o INSERT_ROWS) |
| `includeValuesInResponse` | boolean | No | Si se deben incluir los valores añadidos en la respuesta |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `tableRange` | string | Rango de la tabla donde se añadieron los datos |
| `updatedRange` | string | Rango de celdas que fueron actualizadas |
| `updatedRows` | number | Número de filas actualizadas |
| `updatedColumns` | number | Número de columnas actualizadas |
| `updatedCells` | number | Número de celdas actualizadas |
| `metadata` | json | Metadatos de la hoja de cálculo incluyendo ID y URL |

## Notas

- Categoría: `tools`
- Tipo: `google_sheets`

| Parámetro | Tipo | Requerido | Descripción |
| --------- | ---- | --------- | ----------- |
| `spreadsheetId` | string | Sí | ID de la hoja de cálculo de Google Sheets |
| `includeGridData` | boolean | No | Si se deben incluir datos de cuadrícula \(valores de celdas\). Por defecto es false. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | El ID de la hoja de cálculo |
| `title` | string | El título de la hoja de cálculo |
| `locale` | string | La configuración regional de la hoja de cálculo |
| `timeZone` | string | La zona horaria de la hoja de cálculo |
| `spreadsheetUrl` | string | URL de la hoja de cálculo |
| `sheets` | array | Lista de hojas en la hoja de cálculo |
|   ↳ `sheetId` | number | El ID de la hoja |
|   ↳ `title` | string | El título/nombre de la hoja |
|   ↳ `index` | number | El índice de la hoja \(posición\) |
|   ↳ `rowCount` | number | Número de filas en la hoja |
|   ↳ `columnCount` | number | Número de columnas en la hoja |
|   ↳ `hidden` | boolean | Si la hoja está oculta |

### `google_sheets_create_spreadsheet`

Crear una nueva hoja de cálculo de Google Sheets

#### Entrada

| Parámetro | Tipo | Requerido | Descripción |
| --------- | ---- | --------- | ----------- |
| `title` | string | Sí | El título de la nueva hoja de cálculo |
| `sheetTitles` | json | No | Array de nombres de hojas a crear \(ej., \["Hoja1", "Datos", "Resumen"\]\). Por defecto es una sola "Hoja1". |
| `locale` | string | No | La configuración regional de la hoja de cálculo \(ej., "es_ES"\) |
| `timeZone` | string | No | La zona horaria de la hoja de cálculo \(ej., "Europe/Madrid"\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | El ID de la hoja de cálculo creada |
| `title` | string | El título de la hoja de cálculo creada |
| `spreadsheetUrl` | string | URL de la hoja de cálculo creada |
| `sheets` | array | Lista de hojas creadas en la hoja de cálculo |
|   ↳ `sheetId` | number | El ID de la hoja |
|   ↳ `title` | string | El título/nombre de la hoja |
|   ↳ `index` | number | El í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ámetro | Tipo | Requerido | Descripción |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Sí | ID de la hoja de cálculo de Google Sheets |
| `ranges` | json | Sí | Array de rangos a leer \(ej., \["Hoja1!A1:D10", "Hoja2!A1:B5"\]\). Cada rango debe incluir el nombre de la hoja. |
| `majorDimension` | string | No | La dimensión principal de los valores: "ROWS" \(predeterminado\) o "COLUMNS" |
| `valueRenderOption` | string | No | Cómo deben renderizarse los valores: "FORMATTED_VALUE" \(predeterminado\), "UNFORMATTED_VALUE" o "FORMULA" |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | El ID de la hoja de cálculo |
| `valueRanges` | array | Array de rangos de valores leídos de la hoja de cálculo |
|   ↳ `range` | string | El rango que fue leído |
|   ↳ `majorDimension` | string | Dimensión principal \(ROWS o COLUMNS\) |
|   ↳ `values` | array | Los valores de las celdas como un array 2D |
| `metadata` | json | Metadatos de la hoja de cálculo incluyendo ID y URL |
|   ↳ `spreadsheetId` | string | ID de la hoja de cálculo de Google Sheets |
|   ↳ `spreadsheetUrl` | string | URL 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ámetro | Tipo | Requerido | Descripción |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Sí | ID de la hoja de cálculo de Google Sheets |
| `data` | json | Sí | Array de rangos de valores a actualizar. Cada elemento debe tener "range" \(ej., "Sheet1!A1:D10"\) y "values" \(array 2D\). |
| `valueInputOption` | string | No | Cómo deben interpretarse los datos de entrada: "RAW" o "USER_ENTERED" \(predeterminado\). USER_ENTERED analiza fórmulas. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | El ID de la hoja de cálculo |
| `totalUpdatedRows` | number | Número total de filas actualizadas |
| `totalUpdatedColumns` | number | Número total de columnas actualizadas |
| `totalUpdatedCells` | number | Número total de celdas actualizadas |
| `totalUpdatedSheets` | number | Número total de hojas actualizadas |
| `responses` | array | Array de respuestas de actualización para cada rango |
|   ↳ `spreadsheetId` | string | El ID de la hoja de cálculo |
|   ↳ `updatedRange` | string | El rango que fue actualizado |
|   ↳ `updatedRows` | number | Número de filas actualizadas en este rango |
|   ↳ `updatedColumns` | number | Número de columnas actualizadas en este rango |
|   ↳ `updatedCells` | number | Número de celdas actualizadas en este rango |
| `metadata` | json | Metadatos de la hoja de cálculo incluyendo ID y URL |
|   ↳ `spreadsheetId` | string | ID de la hoja de cálculo de Google Sheets |
|   ↳ `spreadsheetUrl` | string | URL 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ámetro | Tipo | Requerido | Descripción |
| --------- | ---- | --------- | ----------- |
| `spreadsheetId` | string | Sí | ID de la hoja de cálculo de Google Sheets |
| `ranges` | json | Sí | Array de rangos a borrar \(ej., \["Hoja1!A1:D10", "Hoja2!A1:B5"\]\). Cada rango debe incluir el nombre de la hoja. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | El ID de la hoja de cálculo |
| `clearedRanges` | array | Array de rangos que fueron borrados |
| `metadata` | json | Metadatos de la hoja de cálculo incluyendo ID y URL |
|   ↳ `spreadsheetId` | string | ID de la hoja de cálculo de Google Sheets |
|   ↳ `spreadsheetUrl` | string | URL de la hoja de cálculo |

### `google_sheets_copy_sheet`

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

#### Entrada

| Parámetro | Tipo | Requerido | Descripción |
| --------- | ---- | --------- | ----------- |
| `sourceSpreadsheetId` | string | Sí | ID de la hoja de cálculo de Google Sheets de origen |
| `sheetId` | number | Sí | El 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. |
| `destinationSpreadsheetId` | string | Sí | El ID de la hoja de cálculo de destino donde se copiará la hoja |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `sheetId` | number | El ID de la hoja recién creada en el destino |
| `title` | string | El título de la hoja copiada |
| `index` | number | El índice \(posición\) de la hoja copiada |
| `sheetType` | string | El tipo de la hoja \(GRID, CHART, etc.\) |
| `destinationSpreadsheetId` | string | El ID de la hoja de cálculo de destino |
| `destinationSpreadsheetUrl` | string | URL a la hoja de cálculo de destino |
