L'API Fogli Google consente di aggiungere, rimuovere e modificare righe e colonne nei fogli. Gli esempi in questa pagina mostrano come eseguire alcune operazioni comuni su righe e colonne con l'API Fogli.
Questi esempi sono presentati sotto forma di richieste HTTP per essere neutrali dal linguaggio. Per informazioni su come implementare un aggiornamento batch in diversi linguaggi 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 dovresti fornire questi ID. Puoi trovare l'ID del foglio di lavoro nell'URL del foglio di lavoro. 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.
Modificare la larghezza delle colonne o l'altezza della riga
Il seguente
esempio di codice di 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" } } ] }
Aggiungere righe o colonne vuote
Il seguente esempio di codice di 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 esempio di codice di spreadsheets.batchUpdate
mostra come utilizzare AutoResizeDimensionsRequest
per ridimensionare le colonne A:C, in base alle dimensioni dei loro contenuti. Il campo dimension
indica che l'operazione viene applicata 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
}
}
}
]
}
Ridimensiona automaticamente una riga
Il seguente esempio di codice di spreadsheets.batchUpdate
mostra come utilizzare AutoResizeDimensionsRequest
per cancellare l'altezza delle righe delle prime tre righe. L'altezza delle righe aumenta in modo dinamico in base al contenuto delle celle di ogni riga. Il campo dimension
indica che l'operazione viene applicata 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 di spreadsheets.batchUpdate
mostra come utilizzare DeleteDimensionRequest
per eliminare le prime tre righe in 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 di spreadsheets.batchUpdate
mostra come utilizzare InsertDimensionRequest
per inserire colonne o righe in un determinato indice (ad esempio anteporre 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 che iniziano dalla riga 1.
Il campo dimension
determina se l'operazione si applica alle colonne o alle righe di un foglio.
Se il valore è vero, il campo inheritFromBefore
indica all'API Fogli di assegnare
alle nuove colonne o righe le stesse proprietà della riga o colonna precedente e, se
falso, di ereditare dalle dimensioni dopo le nuove colonne o righe.
inheritFromBefore
non può essere true se si inserisce 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 esempio di codice di 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 con 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 } }, ], }