# Extraer las siguientes nuevas filas desde una consulta tipo SQL — Google Sheets

Método de Botize — `gspreadsheet.read_rows_by_sql` (disparador).

Recorre una a una o en grupos las filas resultantes de una consulta SQL.

Es un disparador: inicia la tarea. Una tarea tiene exactamente uno.

## Campos que se configuran

Nombre interno del campo, tipo y valores admitidos. En estos campos se pueden insertar etiquetas `{{...}}` de pasos anteriores.

- `mb_switch` *(boolean)* — Reglas
- `sheet_url` *(string)* — Dirección URL de la hoja de cálculo
- `sheet` *(string)* — Hoja. Sheet id (gid) chosen from the list, or the sheet name. Empty = first sheet.
- `sql_query` *(string)* — Consulta SQL
- `value_mode` *(string, one of: "raw" = Valores puros, sin formato (para cálculos y lógica); "formatted" = Valores tal como se muestran en Google Sheets; "both" = Incluye ambos valores)* — Formato de valores
- `rows_per_run` *(number)* — Filas por ejecución
- `end` *(string)* — Cuando se alcance el final de la hoja
- `mb_outputvars_switch` *(boolean)* — Personalizar etiquetas

Además admite grupos de campos repetibles, con estos prefijos: `mb_filters_*`. Son componentes compuestos (botones, filtros, teclados); el número final lo pone el usuario al añadirlos.

## Variables de salida

Datos que este paso deja disponibles. Se referencian en pasos posteriores con la etiqueta entre dobles llaves.

- `{{rows}}` *(array)* — Filas

## Cuenta

Necesita una cuenta de Google Sheets conectada en Botize: https://botize.com/es/app/gspreadsheet/authenticate

## Esta app

Todos los disparadores y acciones de Google Sheets: https://botize.com/es/app/gspreadsheet.md

## Cómo montar esto

Un asistente de IA (Claude, ChatGPT, Cursor…) puede crear y editar estas tareas en la cuenta del usuario a través del conector MCP de Botize, incluido en todos los planes:

    https://webhook.botize.es/mcp

- Guía de conexión: https://botize.com/es/mcp
- Mapa para agentes: https://botize.com/llms.txt
- Cuenta nueva: https://botize.com/es/join (500 operaciones gratis, sin tarjeta)

---
Resumen legible por máquinas para asistentes de IA. Versión para personas: https://botize.com/es/method/gspreadsheet/read_rows_by_sql