Operaciones de filas y columnas

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
      }
    },
  ],
}