Además de los datos de valor que contienen sus celdas, una hoja de cálculo incluye muchos otros tipos de datos, como los siguientes:
- Dimensiones
- Formatos y bordes de celdas
- Rangos con nombre
- Rangos protegidos
- Formato condicional
Estos son algunos de los muchos tipos de datos que controlan la apariencia 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, de modo que, si una solicitud no se realiza correctamente, no se escriban los demás cambios (que podrían ser dependientes).
En esta página, se describen los conceptos básicos para usar el
spreadsheets.batchUpdate
método. Si necesitas leer y escribir datos de valores de celdas, también puedes usar el
spreadsheets.values
recurso que se describe en
Cómo leer y escribir valores de celdas.
Categorías de operación
Las operaciones particulares admitidas por spreadsheets.batchUpdate se pueden agrupar en las siguientes categorías generales:
| Categoría | Descripción |
|---|---|
| Agregar (y Duplicar) | Agrega objetos nuevos (a veces, basados en objetos antiguos, como en las solicitudes de duplicación). |
| Actualizar (y Establecer) | Actualiza ciertas propiedades de un objeto y, por lo general, deja las propiedades antiguas sin cambios (mientras que una solicitud de establecimiento reemplaza los datos anteriores). |
| Borrar | Quita objetos. |
Estas categorías se usan en la siguiente sección para describir el comportamiento de operaciones específicas.
Operaciones de actualización por lotes
El método spreadsheets.batchUpdate funciona tomando uno o más
objetos de solicitud, cada uno de los cuales especifica un solo tipo de solicitud para realizar. Existen muchos tipos diferentes de solicitudes. A continuación, se muestra 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 se pueden guardar en Google Drive.
Máscaras de campo
Muchas de las solicitudes de "actualización" requieren máscaras de campo. Se trata de una lista de campos delimitada por comas para actualizar solo ciertos campos en un objeto y dejar los demás 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 revertir 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 el
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 nuevo título de la hoja de cálculo.
Respuestas
Cuando actualizas una hoja de cálculo, algunos tipos de solicitudes pueden mostrar respuestas. Estas se muestran en un array, y cada respuesta ocupa el mismo índice que la solicitud correspondiente. Algunas solicitudes no tienen respuestas y, para esas, la respuesta está vacía.
Por lo general, las solicitudes de "agregar" tienen respuestas que muestran información, como el ID del objeto agregado. Para obtener 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
findyreplacement.