Además de los datos de valores que contienen sus celdas, una hoja de cálculo incluye muchos otros tipos de datos, como los siguientes:
- Dimensiones
- Formatos y bordes de las celdas
- Rangos con nombre
- Rangos protegidos
- Formato condicional
Estos son algunos de los numerosos tipos de datos que controlan el aspecto y el funcionamiento de una hoja de cálculo. El método spreadsheets.batchUpdate
te permite actualizar cualquiera de estos detalles de la hoja de cálculo. Los cambios se agrupan en un lote para que no se escriba ninguno de los demás (potencialmente dependientes) si una solicitud no se realiza correctamente.
En esta página, se describen los aspectos básicos del uso del método spreadsheets.batchUpdate
. Si necesitas leer y escribir datos de valores de celdas, también puedes usar el recurso spreadsheets.values
que se describe en Cómo leer y escribir valores de celdas.
Categorías de las operaciones
Las operaciones específicas compatibles con spreadsheets.batchUpdate
se pueden agrupar en las siguientes categorías amplias:
Categoría | Descripción |
---|---|
Agregar (y Duplicar) | Agrega objetos nuevos (a veces basados en objetos antiguos, como en las solicitudes duplicadas). |
Actualizar (y Establecer) | Actualiza ciertas propiedades de un objeto, por lo general, deja solas las propiedades anteriores (mientras que una solicitud Set reemplaza los datos anteriores). |
Borrar | Quitar objetos. |
En la siguiente sección, se usan estas categorías para describir el comportamiento de operaciones específicas.
Operaciones de actualización por lotes
El método spreadsheets.batchUpdate
toma uno o más objetos Request, cada uno de los cuales especifica un solo tipo de solicitud que se realizará. Existen muchos tipos diferentes de solicitudes. A continuación, se detalla un desglose de los tipos de solicitudes, agrupados en diferentes categorías.
También hay algunas solicitudes adicionales que imitan las acciones del usuario para manipular datos:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
Límites
Para obtener más información sobre los límites de celdas y filas en Hojas de cálculo de Google, consulta Archivos que puedes almacenar en Google Drive.
Máscaras de campo
Muchas de las solicitudes de “actualización” requieren máscaras de campo. Estas son una lista de campos delimitados por comas para actualizar solo ciertos campos de un objeto y dejar los otros campos sin cambios. Una máscara de campo de *
se trata como un comodín y es una abreviatura para especificar cada campo en un mensaje (lo que significa que un campo puede volver a su estado predeterminado si no especificas un valor para él en la solicitud).
Para obtener más información sobre las máscaras de campo, consulta Usa máscaras de campo.
En el siguiente ejemplo, se usa UpdateSpreadsheetPropertiesRequest
para actualizar solo el título de una hoja de cálculo:
Solicitud:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
Cuerpo de la solicitud:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
Reemplaza TITLE por el título nuevo de la hoja de cálculo.
Respuestas
Al actualizar una hoja de cálculo, algunos tipos de solicitudes pueden devolver respuestas. Estos se muestran en un arreglo y cada respuesta ocupa el mismo índice que la solicitud correspondiente. Algunas solicitudes no tienen respuestas y, para ellas, la respuesta está vacía.
Por lo general, las solicitudes para “agregar” tienen respuestas que muestran información como el ID del objeto agregado. Para ver la lista de respuestas admitidas, consulta Respuestas.
Ejemplo
En la siguiente muestra de código, se realizan estas acciones:
- Actualiza el título de la hoja de cálculo con la variable
title
. - Busca y reemplaza los valores de las celdas en la hoja de cálculo con las variables
find
yreplacement
.