Skip to main content

​
Configuración básica

Puedes instalar la integración de Google Sheets directamente desde nuestro Marketplace. Una vez instalada, podrás crear hojas, leer y escribir rangos, anexar datos y gestionar pestañas.

​
Funcionalidades

​
Crear hoja de cálculo

Crear una nueva hoja de cálculo con título y, opcionalmente, pestañas iniciales. Inputs:
  • title (string) — Título de la hoja de cálculo.
  • sheets (opcional, array de objetos) — Lista de pestañas a crear, cada una con title (string).
Ejemplo: 
{
  "title": "Reporte Ventas Q4",
  "sheets": [
    { "title": "Resumen" },
    { "title": "Detalle" }
  ]
}

​
Obtener metadatos de una hoja de cálculo

Obtener metadatos de una hoja de cálculo (pestañas, propiedades y URL). Inputs:
  • spreadsheetId (string) — ID de la hoja de cálculo.
Ejemplo: 
{
  "spreadsheetId": "1AbCdEfGhIjKlMnOpQrStUvWxYz-1234567890"
}

​
Listar hojas de cálculo

Listar hojas de cálculo del usuario con filtros y paginación (consulta a Google Drive). Inputs:
  • pageSize (opcional, number) — Cantidad de elementos a devolver (default 10, máximo 100).
  • pageToken (opcional, string) — Token para obtener la siguiente página.
  • query (opcional, string) — Filtro adicional de Drive, p. ej. name contains 'report'.
  • orderBy (opcional, string) — Orden, por defecto 'modifiedTime desc'.
Ejemplo: 
{
  "pageSize": 20,
  "pageToken": "next-page-token",
  "query": "name contains 'Reporte'",
  "orderBy": "modifiedTime desc"
}

​
Leer valores

Leer valores de un rango. Inputs:
  • spreadsheetId (string) — ID de la hoja de cálculo.
  • range (string) — Rango a leer (p. ej. "Hoja1!A1:C10").
Ejemplo: 
{
  "spreadsheetId": "1AbCdEfGhIjKlMnOpQrStUvWxYz-1234567890",
  "range": "Hoja1!A1:C10"
}

​
Escribir valores

Escribir valores en un rango (sobrescribe valores existentes). Inputs:
  • spreadsheetId (string) — ID de la hoja de cálculo.
  • range (string) — Rango a escribir.
  • values (array 2D) — Matriz de valores a escribir (tipos permitidos: string, number, boolean, null).
  • valueInputOption (opcional, enum: RAW | USER_ENTERED) — Cómo interpretar la entrada (por defecto USER_ENTERED).
Ejemplo: 
{
  "spreadsheetId": "1AbCdEfGhIjKlMnOpQrStUvWxYz-1234567890",
  "range": "Hoja1!A1:C2",
  "values": [
    ["Nombre", "Total", "Activo"],
    ["Ana", 120.5, true]
  ],
  "valueInputOption": "USER_ENTERED"
}

​
Anexar valores

Anexar (agregar al final) valores a un rango. Inputs:
  • spreadsheetId (string) — ID de la hoja de cálculo.
  • range (string) — Rango base para anexar (p. ej. "Hoja1!A:A").
  • values (array 2D) — Matriz de valores a anexar.
  • valueInputOption (opcional, enum: RAW | USER_ENTERED) — Interpretación de la entrada (por defecto USER_ENTERED).
Ejemplo: 
{
  "spreadsheetId": "1AbCdEfGhIjKlMnOpQrStUvWxYz-1234567890",
  "range": "Hoja1!A:C",
  "values": [
    ["Carlos", 80.75, false],
    ["María", 200, true]
  ],
  "valueInputOption": "USER_ENTERED"
}

​
Limpiar valores

Limpiar (borrar) los valores de un rango. Inputs:
  • spreadsheetId (string) — ID de la hoja de cálculo.
  • range (string) — Rango a limpiar.
Ejemplo: 
{
  "spreadsheetId": "1AbCdEfGhIjKlMnOpQrStUvWxYz-1234567890",
  "range": "Hoja1!B2:D100"
}

​
Crear pestaña

Crear una nueva pestaña dentro de una hoja de cálculo existente. Inputs:
  • spreadsheetId (string) — ID de la hoja de cálculo.
  • title (string) — Título de la nueva pestaña.
Ejemplo: 
{
  "spreadsheetId": "1AbCdEfGhIjKlMnOpQrStUvWxYz-1234567890",
  "title": "Resultados 2025"
}