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 uno qualsiasi di questi dettagli del foglio di lavoro. Le modifiche vengono raggruppate in un batch in modo che, se una richiesta non va a buon fine, non venga scritta nessuna delle altre modifiche (potenzialmente dipendenti).
Questa pagina descrive le nozioni di base sull'utilizzo del
spreadsheets.batchUpdate
metodo. Se devi leggere e scrivere i dati dei valori delle celle, puoi anche utilizzare la
spreadsheets.values
risorsa 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) | Aggiungi nuovi oggetti (a volte basati su quelli precedenti, come nelle richieste di duplicazione). |
| Aggiorna (e Imposta) | Aggiorna determinate proprietà di un oggetto, in genere lasciando invariate le proprietà precedenti (mentre una richiesta di impostazione sovrascrive i dati precedenti). |
| Elimina | Rimuovi 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ù
Request
oggetti, ognuno dei quali specifica un singolo tipo di richiesta da eseguire. Esistono molti tipi diversi di richieste. Ecco una suddivisione dei tipi di richieste, raggruppati in categorie diverse.
Esistono anche alcune richieste aggiuntive che imitano le azioni dell'utente per la manipolazione dei dati:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
Limiti
Per saperne 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 delimitato da virgole per aggiornare solo determinati campi in un oggetto, lasciando invariati gli altri. Una maschera di campo * viene trattata come un carattere jolly ed è una scorciatoia per specificare ogni campo in 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 il
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. Questi vengono restituiti 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
findereplacement.