L'API Fogli Google consente di aggiornare la formattazione di celle e intervalli all'interno dei fogli di lavoro. Gli esempi in questa pagina illustrano come alcune le operazioni di formattazione possono essere eseguite con l'API Fogli. Puoi puoi trovare altri esempi di formattazione condizionale nella sezione formattazione della formula.
Quando aggiorni un foglio di lavoro, alcuni tipi di richieste potrebbero restituire risposte.
Questi vengono restituiti in un array, con ogni risposta che occupa lo stesso indice di
la richiesta corrispondente. Alcune richieste non hanno risposte e per quelle
la risposta è vuota. La struttura della risposta per questi esempi è disponibile sotto
spreadsheets.batchUpdate
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.
Nel video precedente imparerai a formattare le celle del foglio di lavoro in vari modi, tra cui: creazione di righe bloccate, celle in grassetto, implementazione della valuta formattazione, convalida delle celle e limitazione dei valori delle celle.
Modifica i bordi delle celle
Le seguenti
spreadsheets.batchUpdate
l'esempio di codice mostra come utilizzare
UpdateBordersRequest
per assegnare a ciascuna cella nell'intervallo A1:F10 un bordo superiore e inferiore blu tratteggiato. La
Il campo innerHorizontal crea bordi orizzontali all'interno dell'intervallo.
Se il campo viene omesso, i bordi verranno aggiunti solo nella parte superiore e
inferiore all'intero intervallo.
Il protocollo di richiesta è mostrato di seguito.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"updateBorders": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 6
},
"top": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
"bottom": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
"innerHorizontal": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
}
}
]
}
Formattare una riga di intestazione
Le seguenti
spreadsheets.batchUpdate
l'esempio di codice mostra come utilizzare
RepeatCellRequest
per formattare una riga di intestazione in un foglio. La prima richiesta aggiorna il colore del testo,
colore di sfondo, dimensioni del carattere del testo e giustificazione del testo e rende
testo in grassetto. Se gli indici di colonna vengono omessi nel campo range, viene eseguita l'intera
riga da formattare. La seconda richiesta regola le proprietà del foglio in modo che
riga di intestazione è bloccata.
Il protocollo di richiesta è mostrato di seguito.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 1
},
"cell": {
"userEnteredFormat": {
"backgroundColor": {
"red": 0.0,
"green": 0.0,
"blue": 0.0
},
"horizontalAlignment" : "CENTER",
"textFormat": {
"foregroundColor": {
"red": 1.0,
"green": 1.0,
"blue": 1.0
},
"fontSize": 12,
"bold": true
}
}
},
"fields": "userEnteredFormat(backgroundColor,textFormat,horizontalAlignment)"
}
},
{
"updateSheetProperties": {
"properties": {
"sheetId": SHEET_ID,
"gridProperties": {
"frozenRowCount": 1
}
},
"fields": "gridProperties.frozenRowCount"
}
}
]
}
Unisci celle
Le seguenti
spreadsheets.batchUpdate
l'esempio di codice mostra come utilizzare
MergeCellsRequest
per unire le celle. La prima richiesta unisce l'intervallo A1:B2 in un'unica cella. La
la seconda richiesta unisce le colonne in A3:B6, lasciando separate le righe.
Il protocollo di richiesta è mostrato di seguito.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"mergeCells": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 2,
"startColumnIndex": 0,
"endColumnIndex": 2
},
"mergeType": "MERGE_ALL"
}
},
{
"mergeCells": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 2,
"endRowIndex": 6,
"startColumnIndex": 0,
"endColumnIndex": 2
},
"mergeType": "MERGE_COLUMNS"
}
},
]
}
Impostare un formato data/ora o decimale personalizzato per un intervallo
Le seguenti
spreadsheets.batchUpdate
l'esempio di codice mostra come utilizzare
RepeatCellRequest
per aggiornare le celle in modo che abbiano formati data/ora e numeri personalizzati. La prima richiesta
assegna alle celle dell'intervallo A1:A10 il formato data/ora personalizzato hh:mm:ss am/pm,
ddd mmm dd yyyy. Un esempio di data/ora in questo formato è: "02:05:07 PM, dom apr
03 2016".
La seconda richiesta fornisce alle celle in B1:B10 il formato numerico personalizzato
#,##0.0000, che indica che i numeri devono essere raggruppati con una virgola
separatori, che siano presenti quattro cifre decimali e che tutte tranne
uno zero iniziale deve essere eliminato. Ad esempio, il numero "3,14" viene eseguito il rendering
come "3.1400", mentre "12345.12345" viene visualizzato come "12,345.1235".
Il protocollo di richiesta è mostrato di seguito.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 1
},
"cell": {
"userEnteredFormat": {
"numberFormat": {
"type": "DATE",
"pattern": "hh:mm:ss am/pm, ddd mmm dd yyyy"
}
}
},
"fields": "userEnteredFormat.numberFormat"
}
},
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 1,
"endColumnIndex": 2
},
"cell": {
"userEnteredFormat": {
"numberFormat": {
"type": "NUMBER",
"pattern": "#,##0.0000"
}
}
},
"fields": "userEnteredFormat.numberFormat"
}
}
]
}