Google Sheets — Clear range

Tipo: googlesheets-clear-range · Paquete: Google Sheets Activities v1.0.5 · Salida: —

Borra el contenido de un rango de celdas. Útil para limpiar datos anteriores antes de escribir nuevos, de modo que no queden filas viejas debajo. Elimina solo los valores (y fórmulas), no el formato: colores, bordes y anchos se conservan.

Cómo funciona

Vacía las celdas del range indicado en la hoja sheet (la primera si se omite) con una llamada a Google. Limpiar un rango que ya está vacío no es un error. El cambio es inmediato y no se puede deshacer desde el robot (sí desde el historial de versiones de la hoja).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`range`	`string`	—	Rango a limpiar en notación A1: `A1:Z100`, `A:Z` (columnas completas), `2:1000` (filas).

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`	—	Nombre de la hoja. Si se omite, se usa la primera hoja.

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
`'range' es obligatorio.`	`range` 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.
`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.

Ejemplo

Limpiar los datos (conservando los títulos de la fila 1) y reescribirlos:

Google Sheets — Clear range   session = hoja   sheet = "Resultados"   range = "A2:Z"
Google Sheets — Write range   session = hoja   sheet = "Resultados"   range = "A2"   values = nuevos

Actividades relacionadas

Write sheet — escribir datos nuevos.
Used range — saber qué área tiene datos.