L'API Fogli Google ti consente di aggiungere, rimuovere e manipolare 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 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 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 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 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. Le altezze delle righe aumentano quindi dinamicamente in base ai contenuti 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
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
}
}
},
],
}Inserisci una riga o una colonna vuota
Il seguente
spreadsheets.batchUpdate
codice di esempio mostra come utilizzare il comando
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 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.
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 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
}
},
],
}