Google Sheets — Find cell

Tipo: googlesheets-find-cell · Paquete: Google Sheets Activities v1.0.0 · Salida: Dictionary

Busca un valor en la hoja y devuelve la ubicación de la primera celda que coincide. Es el “Buscar” de Google Sheets desde el bot.

Cómo funciona

Recorre la hoja (o el range indicado) buscando value según el match-type, y devuelve la primera coincidencia, o nulo si no la encuentra. La comparación es insensible a mayúsculas.

Parámetros requeridos

Parámetro	Editor	Descripción
`value`	expresión	Valor a buscar.

Parámetros opcionales

Parámetro	Editor	Descripción
`session`	sesión	Sesión de Google Sheets — Open. Opcional: dentro de un `body` se hereda.
`sheet`	expresión	Hoja donde buscar.
`range`	expresión	Limitar a un rango. Por defecto, toda la hoja.
`match-type`	lista	Comparación: `exact` (def.) · `contains` · `starts-with`.

Salida

Devuelve un Dictionary con address, row, column, value, o nulo si no hay coincidencia.

Ejemplo

Google Sheets — Find cell   session = = hoja   value = "Total"   → output: celda
If   condition = = !isNull(celda)
 └─ then:
      Log   message = = "Encontrada en " + celda["address"]

Actividades relacionadas

Find row — encontrar una fila completa por una columna.
Read cell — leer una celda en posición conocida.