Operazioni su righe e colonne

L'API Google Sheets ti consente di aggiungere, rimuovere e manipolare righe e colonne nei fogli. Gli esempi in questa pagina illustrano come eseguire alcune operazioni comuni su righe e colonne con l'API Sheets.

Questi esempi sono presentati sotto forma di richieste HTTP per essere indipendenti dalla lingua. Per scoprire come implementare un aggiornamento batch in diverse lingue utilizzando le librerie client delle API di Google, consulta Aggiornare i fogli di lavoro.

In questi esempi, i segnaposto SPREADSHEET_ID e SHEET_ID indicano dove devi fornire questi ID. Puoi trovare l'ID del foglio di lavoro nell'URL del foglio. Puoi ottenere l'ID foglio utilizzando il metodo spreadsheets.get. Gli intervalli vengono specificati utilizzando la notazione A1. Un intervallo di esempio è Foglio1!A1:D5.

Regolare la larghezza delle colonne o l'altezza delle righe

Il seguente spreadsheets.batchUpdate esempio di codice mostra come utilizzare UpdateDimensionPropertiesRequest per aggiornare la proprietà della larghezza della colonna A a 160 pixel. Una seconda richiesta aggiorna l'altezza della riga delle prime tre righe a 40 pixel. Il campo dimension determina se l'operazione si applica alle colonne o alle righe di un foglio.

Il protocollo di richiesta è mostrato di seguito.

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

Aggiungere righe o colonne vuote

Il seguente esempio di codice spreadsheets.batchUpdate mostra come utilizzare AppendDimensionRequest per aggiungere righe e colonne. La prima richiesta aggiunge tre righe vuote alla fine di un foglio, mentre la seconda aggiunge una singola colonna vuota. Il campo dimension determina se l'operazione si applica alle colonne o alle righe di un foglio.

Il protocollo di richiesta è mostrato di seguito.

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

Ridimensionare automaticamente una colonna

Il seguente spreadsheets.batchUpdate esempio di codice mostra come utilizzare AutoResizeDimensionsRequest per ridimensionare le colonne A:C in base alle dimensioni dei contenuti delle colonne. Il campo dimension indica che l'operazione si applica alle colonne del foglio.

Il protocollo di richiesta è mostrato di seguito.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

Ridimensionare automaticamente una riga

Il seguente esempio di codice spreadsheets.batchUpdate mostra come utilizzare AutoResizeDimensionsRequest per cancellare le altezze delle righe delle prime tre righe. L'altezza delle righe aumenta dinamicamente in base al contenuto delle celle di ogni riga. Il campo dimension indica che l'operazione si applica alle righe del foglio.

Il protocollo di richiesta è mostrato di seguito.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

Eliminazione di righe o colonne

Il seguente spreadsheets.batchUpdate esempio di codice mostra come utilizzare DeleteDimensionRequest per eliminare le prime tre righe di un foglio. Una seconda richiesta elimina le colonne B:D. Il campo dimension determina se l'operazione si applica alle colonne o alle righe di un foglio.

Il protocollo di richiesta è mostrato di seguito.

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

Inserire una riga o una colonna vuota

Il seguente spreadsheets.batchUpdate esempio di codice mostra come utilizzare InsertDimensionRequest per inserire colonne o righe in un indice specifico (ad esempio anteponendo righe vuote nella parte superiore di un foglio). La prima richiesta inserisce due colonne vuote nella colonna C. Una seconda richiesta inserisce tre righe vuote a partire dalla riga 1.

Il campo dimension determina se l'operazione si applica alle colonne o alle righe di un foglio.

Se è true, il campo inheritFromBefore indica all'API Sheets di assegnare alle nuove colonne o righe le stesse proprietà della riga o colonna precedente e, se false, di ereditare le proprietà dalle dimensioni dopo le nuove colonne o righe. inheritFromBefore non può essere true se viene inserita una riga nella riga 1 o una colonna nella colonna A.

Il protocollo di richiesta è mostrato di seguito.

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

Spostare una riga o una colonna

Il seguente spreadsheets.batchUpdate esempio di codice mostra come utilizzare MoveDimensionRequest per spostare la colonna A nella posizione della colonna D. Una seconda richiesta sposta le righe 5-10 nella posizione della riga 20.

Il campo dimension determina se l'operazione si applica alle colonne o alle righe di un foglio. Il campo destinationIndex determina dove spostare i dati di origine utilizzando un indice iniziale basato su zero.

Il protocollo di richiesta è mostrato di seguito.

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