L'API Fogli Google ti consente di aggiungere, rimuovere e modificare righe e colonne nei fogli. Gli esempi in questa pagina mostrano come eseguire alcune operazioni comuni di righe e colonne con l'API Fogli.
Questi esempi sono presentati sotto forma di richieste HTTP per essere indipendenti dal linguaggio. Per scoprire come implementare un aggiornamento batch in lingue diverse, utilizzando le librerie client delle API di Google, consulta la pagina relativa all'aggiornamento dei 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 ottenere
l'ID del 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 della riga
Il seguente esempio di codice spreadsheets.batchUpdate mostra come utilizzare UpdateDimensionPropertiesRequest per aggiornare la proprietà della larghezza della colonna A a 160 pixel. Una seconda richiesta aggiorna la proprietà dell'altezza della riga delle prime tre righe in modo che sia di 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"
}
}
]
}
Aggiungi 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 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 esempio di codice per spreadsheets.batchUpdate mostra come utilizzare AutoResizeDimensionsRequest per ridimensionare le colonne A:C, in base alle dimensioni dei contenuti della colonna. 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 l'altezza delle righe delle prime tre righe. L'altezza delle righe si espande dinamicamente in base al contenuto delle celle in 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 esempio di codice per spreadsheets.batchUpdate 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
}
}
},
],
}
Inserisci una riga o una colonna vuota
Il seguente esempio di codice spreadsheets.batchUpdate mostra come utilizzare InsertDimensionRequest per inserire colonne o righe in un determinato indice (ad esempio precedere 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 Fogli di assegnare
alle nuove colonne o righe le stesse proprietà della riga o colonna precedente e, in caso contrario, di
ereditare dalle dimensioni dopo le nuove colonne o righe.
inheritFromBefore non può essere true se si inserisce una riga alla 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 esempio di codice spreadsheets.batchUpdate 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 in base 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
}
},
],
}