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 è possibile eseguire alcune operazioni comuni su righe e colonne con l'API Fogli.

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 di lavoro. Puoi ottenere l'ID del foglio utilizzando il spreadsheets.get metodo. Gli intervalli vengono specificati utilizzando la notazione A1. Un esempio di intervallo è Sheet1!A1:D5.

Modificare 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 la proprietà dell'altezza delle righe delle prime tre righe a 40 pixel. Il campo dimension determina se l'operazione si applica alle colonne o alle righe di un foglio.

Di seguito è riportato il protocollo di richiesta.

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 spreadsheets.batchUpdate esempio di codice 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.

Di seguito è riportato il protocollo di richiesta.

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 del contenuto della colonna. Il campo dimension indica che l'operazione si applica alle colonne del foglio.

Di seguito è riportato il protocollo di richiesta.

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 spreadsheets.batchUpdate esempio di codice mostra come utilizzare AutoResizeDimensionsRequest per cancellare le altezze delle prime tre righe. Le altezze delle righe aumentano in modo dinamico in base al contenuto delle celle di ogni riga. Il campo dimension indica che l'operazione si applica alle righe del foglio.

Di seguito è riportato il protocollo di richiesta.

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

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

Eliminare 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.

Di seguito è riportato il protocollo di richiesta.

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 della colonna precedente e, se è false, di ereditare le dimensioni dopo le nuove colonne o righe. inheritFromBefore non può essere true se inserisci una riga nella riga 1 o una colonna nella colonna A.

Di seguito è riportato il protocollo di richiesta.

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.

Di seguito è riportato il protocollo di richiesta.

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