A parte i dati dei valori contenuti nelle celle, foglio di lavoro include molti altri tipi di dati quali:
- Dimensioni
- Formati delle celle e bordi
- Intervalli denominati
- Intervalli protetti
- Formattazione condizionale
Questi sono alcuni dei molti tipi di dati che controllano l'aspetto e
di un foglio di lavoro. Il metodo spreadsheets.batchUpdate
ti consente di
aggiornare uno qualsiasi di questi dettagli del foglio di lavoro. Le modifiche vengono raggruppate in batch,
se una richiesta non va a buon fine, nessuna delle altre (potenzialmente dipendente)
vengono scritte le modifiche.
In questa pagina vengono descritte le nozioni di base per l'utilizzo
spreadsheets.batchUpdate
. Se devi leggere e scrivere i dati dei valori delle celle, puoi anche utilizzare
spreadsheets.values
e la risorsa descritta in Lettura e scrivere i valori delle celle.
Categorie di operazioni
Le operazioni specifiche supportate da spreadsheets.batchUpdate
possono essere raggruppate
nelle seguenti grandi categorie:
Categoria | Descrizione |
---|---|
Aggiungi (e Duplica) | Aggiungi nuovi oggetti (a volte basati su vecchi oggetti, come nelle richieste duplicate). |
Update (e Set) | Aggiorna determinate proprietà di un oggetto, di solito lasciando invariate le vecchie proprietà (mentre una richiesta Set sovrascrive i dati precedenti). |
Elimina | Rimuovi oggetti. |
Queste categorie vengono utilizzate nella prossima sezione per descrivere il comportamento dei per operazioni specifiche.
Operazioni di aggiornamento batch
Il metodo spreadsheets.batchUpdate
funziona prendendo uno o più
Richiedi
specifici, ognuno dei quali specifica un solo tipo di richiesta da eseguire. Esistono
molti tipi diversi di richieste. Ecco un'analisi dei tipi di richieste,
raggruppate in diverse categorie.
Esistono anche altre richieste che imitano le azioni dell'utente per manipolare dati:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
Limiti
Per saperne di più sui limiti di celle e righe in Fogli Google, vedi File archiviabili in Google Drive.
Maschere dei campi
Molti dei "aggiornamenti" le richieste richiedono maschere dei campi. sono delimitate da virgole
di campi per aggiornare solo alcuni campi di un oggetto lasciando l'elenco
gli altri campi non sono stati modificati. Una maschera di campo di *
viene trattata come un
carattere jolly ed è una forma abbreviata per specificare ogni campo di un messaggio (che significa
un campo può tornare allo stato predefinito se non specifichi un valore in
la richiesta).
Per ulteriori informazioni sulle maschere di campo, consulta Utilizza campo.
le mascherine.
Il seguente esempio utilizza la classe
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 una matrice, con ogni risposta che occupa lo stesso indice della a una richiesta corrispondente. Alcune richieste non hanno risposte e per quelle la risposta è vuota.
In genere, "aggiungi" richieste contengono risposte che restituiscono informazioni, come l'ID dell'oggetto aggiunto. Per l'elenco delle risposte supportate, vedi 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
find
ereplacement
variabili.