Además de los datos de valores contenidos en sus celdas, una hoja de cálculo incluye muchos otros tipos de datos, por ejemplo:
- 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 la apariencia y
operación 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
Si una solicitud no tiene éxito, ninguna de las otras (posiblemente dependiente)
se escriben los cambios.
En esta página, se describen los aspectos básicos del uso de las
spreadsheets.batchUpdate
. Si necesitas leer y escribir datos de valores de celdas, también puedes usar el
spreadsheets.values
recurso descrito en Leer y escribir valores de celdas.
Categorías de las operaciones
Las operaciones particulares que admite 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 duplicadas). |
Update (y Set) | Actualizar ciertas propiedades de un objeto, por lo general, dejando las propiedades anteriores solas (mientras que una solicitud Set reemplaza los datos anteriores). |
Borrar | Quitar 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
toma uno o más
Solicitar
cada uno de los cuales especifica
un solo tipo de solicitud para realizar. Existen
muchos tipos diferentes de solicitudes. Este es un desglose de los tipos de solicitudes,
agruparse 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 "actualizaciones" requieren máscaras de campo. Son valores delimitados por comas
una lista de campos para actualizar solo ciertos campos en un objeto y, al mismo tiempo, dejar
otros campos sin modificar. Una máscara de campo de *
se trata como una
y es una abreviatura para especificar cada campo en un mensaje (lo que significa
un campo puede volver a su estado predeterminado si no le especificas un valor en
la solicitud).
Para obtener más información sobre las máscaras de campo, consulta Usar campos
máscaras.
En el siguiente ejemplo, se usa la
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 se actualiza una hoja de cálculo, algunos tipos de solicitudes pueden devolver respuestas. Estos se devuelven en un array, y cada respuesta ocupa el mismo índice que la solicitud correspondiente. Algunas solicitudes no tienen respuestas, y para aquellas de respuesta está vacía.
Por lo general, "agregar" solicitudes tienen respuestas que devuelven información como el ID del objeto agregado. Para ver la lista de respuestas admitidas, consulta Respuestas.
Ejemplo
La siguiente muestra de código realiza estas acciones:
- Actualiza el título de la hoja de cálculo con la variable
title
. - Busca y reemplaza valores de celdas en la hoja de cálculo mediante
find
yreplacement
variables.