L'API Fogli Google consente di aggiungere, rimuovere e modificare righe e colonne in in Fogli Google. Gli esempi in questa pagina illustrano come alcune righe e colonne comuni operazioni possono essere eseguite con l'API Fogli.
Questi esempi sono presentati sotto forma di richieste HTTP per neutri. Per scoprire come implementare un aggiornamento batch in lingue diverse utilizzando le librerie client delle API di Google, consulta l'articolo Aggiornamento fogli di lavoro.
In questi esempi, i segnaposto SPREADSHEET_ID e SHEET_ID
indica dove fornire questi ID. Puoi trovare il foglio di lavoro
ID nell'URL del foglio di lavoro. Puoi ottenere
l'ID foglio utilizzando la proprietà
spreadsheets.get. La
vengono specificati utilizzando la notazione A1. Un
di esempio è Foglio1!A1:D5.
Regolare la larghezza delle colonne o l'altezza della riga
Le seguenti
spreadsheets.batchUpdate
l'esempio di codice mostra come utilizzare
UpdateDimensionPropertiesRequest
per aggiornare la proprietà della larghezza della colonna A a 160 pixel. Viene aggiornata una seconda richiesta
la proprietà altezza riga delle prime tre righe a 40 pixel. dimension
determina se l'operazione si applica alle colonne o alle righe di un
in un foglio di calcolo.
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
Le seguenti
spreadsheets.batchUpdate
l'esempio di codice mostra come utilizzare
AppendDimensionRequest
per aggiungere righe e colonne. La prima richiesta aggiunge tre righe vuote
alla fine di un foglio, mentre il secondo aggiunge una singola colonna vuota. dimension
determina se l'operazione si applica alle colonne o alle righe di un
in un foglio di calcolo.
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
Le seguenti
spreadsheets.batchUpdate
l'esempio di codice mostra come utilizzare
AutoResizeDimensionsRequest
per ridimensionare le colonne A:C in base alle dimensioni dei contenuti delle colonne. 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
Le seguenti
spreadsheets.batchUpdate
l'esempio di codice mostra come utilizzare
AutoResizeDimensionsRequest
per cancellare l'altezza delle prime tre righe. Successivamente, l'altezza delle righe si ingrandisce
in modo dinamico in base al contenuto delle celle di ogni riga. 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
Le seguenti
spreadsheets.batchUpdate
l'esempio di codice 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 oppure
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
Le seguenti
spreadsheets.batchUpdate
l'esempio di codice mostra come utilizzare
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 oppure
righe di un foglio.
Se true, il campo inheritFromBefore indica all'API Fogli di fornire
le nuove colonne o righe avranno le stesse proprietà della riga o colonna precedente e se
false, per ereditare le dimensioni dopo le nuove colonne o righe.
inheritFromBefore non può essere true se si inserisce una riga alla riga 1 o una colonna in corrispondenza di
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
Le seguenti
spreadsheets.batchUpdate
l'esempio di codice mostra come utilizzare
MoveDimensionRequest
per spostare la colonna A alla posizione della colonna D. Una seconda richiesta sposta le righe
5-10 alla posizione della riga 20.
Il campo dimension determina se l'operazione si applica alle colonne oppure
righe di un foglio. Il campo destinationIndex determina dove spostare
dei 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
}
},
],
}