Operaciones con hojas

La API de Google Sheets te permite crear, borrar, copiar y borrar hojas de cálculo. controlan sus propiedades. Los ejemplos de esta página ilustran cómo puedes realizar algunas operaciones comunes de Hojas de cálculo con el 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.

Agregar una hoja

Lo siguiente spreadsheets.batchUpdate de muestra de código muestra cómo usar el AddSheetRequest para agregar una hoja a una hoja de cálculo y, al mismo tiempo, establecer el título, el tamaño de la cuadrícula y color de pestaña.

La respuesta consta de un AddSheetResponse: que contiene un objeto con las propiedades de la hoja creada (como su SHEET_ID).

El protocolo de solicitud se muestra a continuación.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "addSheet": {
        "properties": {
          "title": "Deposits",
          "gridProperties": {
            "rowCount": 20,
            "columnCount": 12
          },
          "tabColor": {
            "red": 1.0,
            "green": 0.3,
            "blue": 0.4
          }
        }
      }
    }
  ]
}

Borrar todos los valores de una hoja sin perder los formatos

Lo siguiente spreadsheets.batchUpdate de muestra de código muestra cómo usar el UpdateCellsRequest para quitar todos los valores de una hoja sin modificar el formato.

Especificar el valor Campo userEnteredValue sin un valor correspondiente se interpreta como una instrucción para borrar valores dentro del rango. Este parámetro de configuración también se puede usar con otros campos. Por ejemplo: cambiando el valor de fields a Se quitó userEnteredFormat todos los formatos compatibles con la API de Hojas de cálculo de la hoja, pero deja los valores de las celdas intactos.

El protocolo de solicitud se muestra a continuación.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "updateCells": {
        "range": {
          "sheetId": SHEET_ID
        },
        "fields": "userEnteredValue"
      }
    }
  ]
}

Copiar una hoja de una hoja de cálculo a otra

Lo siguiente spreadsheet.sheets.copyTo la muestra de código muestra cómo copiar una sola hoja especificada por SHEET_ID de una hoja de cálculo a otra hoja de cálculo.

La variable TARGET_SPREADSHEET_ID en el cuerpo de la solicitud especifica la hoja de cálculo de destino. La copia conserva todos los valores, el formato, las fórmulas y otras propiedades del original. El título de la hoja copiada se establece en "Copiar de [título de la hoja original]".

La respuesta consta de un SheetProperties que describe las propiedades de la hoja creada.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/sheets/SHEET_ID:copyTo
{
  "destinationSpreadsheetId": "TARGET_SPREADSHEET_ID"
}

Cómo borrar una hoja

Lo siguiente spreadsheets.batchUpdate de muestra de código muestra cómo usar el DeleteSheetRequest para borrar una hoja especificada por SHEET_ID.

El protocolo de solicitud se muestra a continuación.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "deleteSheet": {
        "sheetId": SHEET_ID
      }
    }
  ]
}

Leer datos de la hoja

Lo siguiente Muestra de código spreadsheets.get muestra cómo obtener información de las propiedades de sheet desde una hoja de cálculo, especificada por SHEET_ID y SPREADSHEET_ID. Este método suele usarse para determinar la metadatos de las hojas dentro de una hoja de cálculo específica, para que se puedan realizar operaciones adicionales orientar esas hojas. El parámetro de consulta fields especifica solo la propiedad de la hoja. los datos deben devolverse (en lugar de datos de valores de celdas o datos relacionados con la toda la hoja de cálculo).

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?&fields=sheets.properties

La respuesta consta de un Spreadsheet recurso, que contiene un Un objeto Sheet con SheetProperties o de terceros. Si un campo de respuesta determinado se establece con el valor predeterminado, se omite. de la respuesta.

{
  "sheets": [
    {
      "properties": {
        "sheetId": SHEET_ID,
        "title": "Sheet1",
        "index": 0,
        "sheetType": "GRID",
        "gridProperties": {
          "rowCount": 100,
          "columnCount": 20,
          "frozenRowCount": 1
        }
        "tabColor": {
          "blue": 1.0
        }
      },
      ...
  ],
}