Operazioni su righe e colonne

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

Questi esempi sono presentati sotto forma di richieste HTTP per essere indipendenti dalla lingua. Per scoprire come implementare un aggiornamento collettivo in lingue diverse 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 fornire questi ID. Puoi trovare l'ID del foglio di lavoro nell'URL del foglio di lavoro. Puoi recuperare 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 il UpdateDimensionPropertiesRequest per aggiornare la proprietà larghezza della colonna A su 160 pixel. Una seconda richiesta aggiorna la proprietà altezza riga delle prime tre righe in modo che sia pari 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"
      }
    }
  ]
}

Collega righe o colonne vuote

Il seguente spreadsheets.batchUpdate esempio di codice mostra come utilizzare la funzione AppendDimensionRequest per accodare 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 la funzione 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 spreadsheets.batchUpdate esempio di codice mostra come utilizzare il metodo AutoResizeDimensionsRequest per cancellare le altezze delle prime tre righe. Le altezze delle righe aumentano quindi dinamicamente in base ai contenuti 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

L'esempio di codice riportato di seguito mostra come utilizzare DeleteDimensionRequest per eliminare le prime tre righe di un foglio.spreadsheets.batchUpdate 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 codice di esempio mostra come utilizzare il metodo InsertDimensionRequest per inserire colonne o righe in un determinato indice (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 il valore è true, il campo inheritFromBefore indica all'API Fogli di assegnare alle nuove colonne o righe le stesse proprietà della riga o della colonna precedente e, se il valore è false, di ereditare dalle 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.

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 la funzione MoveDimensionRequest per spostare la colonna A nella posizione della colonna D. Una seconda richiesta sposta le righe 5-10 nella posizione 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 di inizio a 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
      }
    },
  ],
}