Además de los datos de valor contenidos en 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 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 para que no se escriba ninguno de los demás (potencialmente dependientes) si una solicitud no tiene éxito.
En esta página, se describen los conceptos 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 que admite 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). |
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 |
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á. Hay muchos tipos diferentes de solicitudes. Aquí hay 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 almacenar 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 delimitados por comas para actualizar solo ciertos campos en un objeto y no modificar los demás. Una máscara de campo *
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 en la solicitud).
Para obtener más información sobre las máscaras de campo, consulta Cómo usar 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 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. Estas se muestran en un array, 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 de "agregar" tienen respuestas que muestran información como el ID del objeto agregado. Para obtener 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 los valores de celdas en la hoja de cálculo con las variables
find
yreplacement
.