La API de Google Sheets te permite agregar, quitar y manipular filas y columnas en las hojas de cálculo. Los ejemplos de esta página ilustran cómo algunas filas y columnas comunes las operaciones se pueden lograr con la API de Hojas de cálculo.
Estos ejemplos se presentan en forma de solicitudes HTTP como lenguaje neutrales. Para aprender a implementar una actualización por lotes en diferentes idiomas con las bibliotecas cliente de la API de Google, consulta Actualización hojas de cálculo.
En estos ejemplos, los marcadores de posición SPREADSHEET_ID
y SHEET_ID
se indica dónde se deben proporcionar esos ID. Puedes encontrar la hoja de cálculo
ID en la URL de la hoja de cálculo. Puedes obtener
el ID de la hoja mediante el
spreadsheets.get
. El
los rangos se especifican con la notación A1. Los
el rango de ejemplo es Hoja1!A1:D5.
Ajustar el ancho de las columnas o la altura de las filas
Lo siguiente
spreadsheets.batchUpdate
de muestra de código muestra cómo usar el
UpdateDimensionPropertiesRequest
para actualizar la propiedad de ancho de la columna A a 160 píxeles. Una segunda solicitud se actualiza
la propiedad de altura de fila de las tres primeras filas sea de 40 píxeles. El dimension
determina si la operación se aplica a columnas o filas de una
de la hoja de cálculo.
El protocolo de solicitud se muestra a continuación.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "updateDimensionProperties": { "range": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 0, "endIndex": 1 }, "properties": { "pixelSize": 160 }, "fields": "pixelSize" } }, { "updateDimensionProperties": { "range": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 0, "endIndex": 3 }, "properties": { "pixelSize": 40 }, "fields": "pixelSize" } } ] }
Agregar filas o columnas vacías
Lo siguiente
spreadsheets.batchUpdate
de muestra de código muestra cómo usar el
AppendDimensionRequest
para adjuntar filas y columnas. La primera solicitud agrega tres filas vacías al
final de una hoja, mientras que la segunda anexa una sola columna vacía. El dimension
determina si la operación se aplica a las columnas o filas de una
de la hoja de cálculo.
El protocolo de solicitud se muestra a continuación.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "appendDimension": { "sheetId":SHEET_ID
, "dimension": "ROWS", "length": 3 } }, { "appendDimension": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "length": 1 } } ] }
Cambiar automáticamente el tamaño de una columna
Lo siguiente
spreadsheets.batchUpdate
de muestra de código muestra cómo usar el
AutoResizeDimensionsRequest
para cambiar el tamaño de las columnas A:C según el tamaño del contenido de la columna. El dimension
indica que la operación se aplica a las columnas de la hoja.
El protocolo de solicitud se muestra a continuación.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID
,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
Cambiar automáticamente el tamaño de una fila
Lo siguiente
spreadsheets.batchUpdate
de muestra de código muestra cómo usar el
AutoResizeDimensionsRequest
para borrar las alturas de fila de las primeras tres filas. Luego, las alturas de las filas aumentan
de forma dinámica según el contenido de las celdas de cada fila. El dimension
indica que la operación se aplica a las filas de la hoja.
El protocolo de solicitud se muestra a continuación.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID
,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
Cómo borrar filas o columnas
Lo siguiente
spreadsheets.batchUpdate
de muestra de código muestra cómo usar el
DeleteDimensionRequest
para eliminar las tres primeras filas de una hoja. Una segunda solicitud borra las columnas B:D.
El campo dimension
determina si la operación se aplica a las columnas o
filas de una hoja.
El protocolo de solicitud se muestra a continuación.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "deleteDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 0, "endIndex": 3 } } }, { "deleteDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 1, "endIndex": 4 } } }, ], }
Cómo insertar una fila o columna vacía
Lo siguiente
spreadsheets.batchUpdate
de muestra de código muestra cómo usar el
InsertDimensionRequest
para insertar columnas o filas en un índice determinado (como anteponer filas vacías)
en la parte superior de una hoja). La primera solicitud inserta dos columnas vacías en la columna C.
La segunda solicitud inserta tres filas vacías que comienzan en la fila 1.
El campo dimension
determina si la operación se aplica a las columnas o
filas de una hoja.
Si es verdadero, el campo inheritFromBefore
le indica a la API de Hojas de cálculo que otorgue
las nuevas columnas o filas tienen las mismas propiedades que la fila o columna anterior y, si
false, para heredar de las dimensiones después de las columnas o filas nuevas.
inheritFromBefore
no puede ser verdadero si se inserta una fila en la fila 1 o una columna en
la columna A.
El protocolo de solicitud se muestra a continuación.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "insertDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 2, "endIndex": 4 }, "inheritFromBefore": true } }, { "insertDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 0, "endIndex": 3 }, "inheritFromBefore": false } }, ], }
Cómo mover una fila o columna
Lo siguiente
spreadsheets.batchUpdate
de muestra de código muestra cómo usar el
MoveDimensionRequest
para mover la columna A a la posición de la columna D. Una segunda solicitud mueve filas
5-10 a la posición de la fila 20.
El campo dimension
determina si la operación se aplica a las columnas o
filas de una hoja. El campo destinationIndex
determina hacia dónde mover el
de origen con un índice de inicio basado en cero.
El protocolo de solicitud se muestra a continuación.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "moveDimension": { "source": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 0, "endIndex": 1 }, "destinationIndex": 3 } }, { "moveDimension": { "source": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 4, "endIndex": 10 }, "destinationIndex": 19 } }, ], }