Oltre ai dati dei valori contenuti nelle sue celle, un foglio di lavoro include molti altri tipi di dati, tra cui:
- Dimensioni
- Bordi e formati delle celle
- Intervalli denominati
- Intervalli protetti
- Formattazione condizionale
Questi sono alcuni dei tanti tipi di dati che controllano l'aspetto e il funzionamento di un foglio di lavoro. Il metodo spreadsheets.batchUpdate
consente di
aggiornare i dettagli dei fogli 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.
In questa pagina vengono descritte le nozioni di base sull'utilizzo del metodo spreadsheets.batchUpdate
. Se devi leggere e scrivere dati sui valori delle celle, puoi anche utilizzare la risorsa spreadsheets.values
descritta in Leggere e scrivere valori delle celle.
Categorie di operazioni
Le operazioni specifiche supportate da spreadsheets.batchUpdate
possono essere raggruppate
nelle seguenti ampie categorie:
Categoria | Descrizione |
---|---|
Aggiungi (e Duplica) | Aggiungi nuovi oggetti (a volte basati su quelli vecchi, come in Richieste duplicate). |
Aggiorna (e Imposta) | Aggiornare determinate proprietà di un oggetto, lasciando in genere le proprietà precedenti (mentre una richiesta di impostazione 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, ciascuno dei quali specifica un singolo tipo di richiesta da eseguire. Esistono molti tipi diversi di richieste. Ecco un'analisi dettagliata dei tipi di richieste,
raggruppate in diverse categorie.
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 scoprire di più sui limiti di celle e righe in Fogli Google, consulta File archiviabili su Google Drive.
Maschere dei campi
Molte delle richieste di "aggiornamento" richiedono maschere di campo. Si tratta di un elenco di campi delimitati da virgole che consentono di aggiornare solo alcuni campi di un oggetto, lasciando invariati gli altri. 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 allo stato predefinito se non specifichi un valore per questo campo nella richiesta).
Per ulteriori informazioni sulle maschere di campo, consulta Utilizzare le maschere di campo.
Il seguente esempio utilizza 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 quelle la risposta è vuota.
In genere, le richieste "add" 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 sostituisci i valori delle celle nel foglio di lavoro utilizzando le variabili
find
ereplacement
.