Google Sheets — Find cell

Tipo: googlesheets-find-cell · Paquete: Google Sheets Activities v1.0.5 · Salida: Dictionary<string,object>

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 robot: localizar un rótulo («Total»), un código o una marca para leer o escribir a su lado.

Cómo funciona

Lee la hoja sheet (la primera si se omite) o solo el range indicado, y recorre las celdas fila por fila, de izquierda a derecha, comparando su texto con value según match-type. Devuelve la primera coincidencia.

La comparación no distingue mayúsculas de minúsculas y se hace contra el texto que se ve en la celda (un número con formato 1.500 se compara como "1.500").
row y column son absolutos en la hoja, aunque busques en un range que no empieza en A1.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`value`	`object`	—	Valor a buscar; se compara como texto.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanGoogleSheetsSession`	—	Sesión de Google Sheets — Open. Dentro del `body` de Open se hereda y puedes omitirla.
`sheet`	`string`	—	Hoja donde buscar. Si se omite, se usa la primera hoja.
`range`	`string`	—	Limita la búsqueda a un rango en notación A1 (p. ej. `A1:Z100`). Por defecto, toda la hoja.
`match-type`	`string`	`exact`	Comparación: `exact` (celda igual al valor), `contains` (la celda contiene el valor) o `starts-with` (la celda empieza por el valor).

Salida

Devuelve un Dictionary con la primera coincidencia, o nulo si no hay ninguna (o si la hoja está vacía):

Clave	Tipo	Contenido
`address`	`string`	Dirección A1 de la celda, p. ej. `C7`.
`row`	`int`	Número de fila (1 = primera fila de la hoja).
`column`	`int`	Número de columna (1 = columna A).
`value`	`string`	Texto completo de la celda encontrada.

Errores comunes

Mensaje	Causa y solución
`'value' es obligatorio.`	`value` quedó vacío o su expresión dio nulo.
`No hay una sesión de Google Sheets disponible. Indica 'session' desde una actividad googlesheets-open o coloca esta actividad dentro del cuerpo de la actividad Open …`	La actividad está fuera del `body` de Open y no recibió `session`. Colócala dentro del `body` o pasa la sesión guardada.
`La hoja de cálculo no tiene hojas para leer.`	Se omitieron `sheet` y `range` y el documento no tiene hojas.
`The service sheets has thrown an exception. HttpStatusCode is …`	Google rechazó la llamada: hoja o rango inexistente, sin acceso, token vencido o cuota superada. Ver errores de la API de Google.

No encontrar el valor no es un error: la salida es nula.

Ejemplo

Encontrar un código y marcar su fila como procesada en la columna F:

Google Sheets — Find cell   session = hoja   sheet = "Pedidos"   value = codigo   → output: celda
If   condition = !isNull(celda)
 └─ then:
      Google Sheets — Write cell   session = hoja   sheet = "Pedidos"
                                   cell = "F" + celda["row"]   value = "Procesado"
      Log   message = "Código encontrado en " + celda["address"]

Actividades relacionadas

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