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