Oltre ai dati dei valori contenuti nelle celle, un foglio di lavoro include molti altri tipi di dati, ad esempio:
- Dimensioni
- Formati e bordi delle celle
- Intervalli denominati
- Intervalli protetti
- Formattazione condizionale
Questi sono alcuni dei molti tipi di dati che controllano l'aspetto e il funzionamento di un foglio di lavoro. Il metodo spreadsheets.batchUpdate
consente di
aggiornare qualsiasi dettaglio del foglio di lavoro. Le modifiche vengono raggruppate in un batch in modo che, se una richiesta non va a buon fine, nessuna delle altre modifiche (potenzialmente dipendenti) venga scritta.
Questa pagina descrive le nozioni di base sull'utilizzo del metodo
spreadsheets.batchUpdate
. Se devi leggere e scrivere i dati dei valori delle celle, puoi anche utilizzare la risorsa
spreadsheets.values
descritta in Leggere e scrivere i valori delle celle.
Categorie di operazioni
Le operazioni specifiche supportate da spreadsheets.batchUpdate
possono essere raggruppate nelle seguenti categorie generali:
Categoria | Descrizione |
---|---|
Aggiungi (e Duplica) | Aggiungere nuovi oggetti (a volte basati su quelli vecchi, come nelle richieste duplicate). |
Aggiorna (e Imposta) | Aggiorna determinate proprietà di un oggetto, in genere lasciando invariate le vecchie proprietà (mentre una richiesta Set sovrascrive i dati precedenti). |
Elimina | Rimuovi gli oggetti. |
Queste categorie vengono utilizzate nella sezione successiva per descrivere il comportamento di operazioni specifiche.
Operazioni di aggiornamento batch
Il metodo spreadsheets.batchUpdate
funziona prendendo uno o più oggetti
Request, ognuno dei quali specifica un singolo tipo di richiesta da eseguire. Esistono
diversi tipi di richieste. Ecco una suddivisione dei tipi di richieste,
gruppate in diverse categorie.
Esistono anche alcune richieste aggiuntive che simulano le azioni utente per manipolare i dati:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
Limiti
Per scoprire di più sui limiti di celle e righe in Fogli Google, consulta File archiviabili su Google Drive.
Maschere di campo
Molte delle richieste di "aggiornamento" richiedono maschere di campo. Si tratta di un elenco di campi delimitati da virgole per aggiornare solo determinati campi in un oggetto lasciando invariati gli altri campi. Una maschera di campo *
viene trattata come un carattere jolly ed è un'abbreviazione per specificare ogni campo di un messaggio (il che significa che un campo potrebbe tornare al suo stato predefinito se non specifichi un valore per esso nella richiesta).
Per saperne di più sulle maschere di campo, consulta Utilizzare le maschere di campo.
L'esempio seguente utilizza la funzione
UpdateSpreadsheetPropertiesRequest
per aggiornare solo il titolo di un foglio di lavoro:
Richiesta:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
Corpo della richiesta:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
Sostituisci TITLE con il nuovo titolo del foglio di lavoro.
Risposte
Quando aggiorni un foglio di lavoro, alcuni tipi di richieste potrebbero restituire risposte. Queste vengono restituite in un array, con ogni risposta che occupa lo stesso indice della richiesta corrispondente. Alcune richieste non hanno risposte e per queste la risposta è vuota.
In genere, le richieste di "aggiunta" hanno risposte che restituiscono informazioni come l'ID dell'oggetto aggiunto. Per l'elenco delle risposte supportate, consulta Risposte.
Esempio
Il seguente esempio di codice esegue queste azioni:
- Aggiorna il titolo del foglio di lavoro utilizzando la variabile
title
. - Trova e sostituisce i valori delle celle nel foglio di lavoro utilizzando le variabili
find
ereplacement
.