- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- Prova!
Imposta i valori in uno o più intervalli di un foglio di lavoro. Il chiamante deve specificare l'ID del foglio di lavoro, un valueInputOption
e uno o più DataFilterValueRanges
.
Richiesta HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
spreadsheetId |
L'ID del foglio di lavoro da aggiornare. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "valueInputOption": enum ( |
Campi | |
---|---|
valueInputOption |
Come dovrebbero essere interpretati i dati di input. |
data[] |
I nuovi valori da applicare al foglio di lavoro. Se il valore |
includeValuesInResponse |
Determina se la risposta all'aggiornamento deve includere i valori delle celle che sono state aggiornate. Per impostazione predefinita, le risposte non includono i valori aggiornati. Il campo |
responseValueRenderOption |
Determina la modalità di rendering dei valori nella risposta. L'opzione di rendering predefinita è |
responseDateTimeRenderOption |
Determina la modalità di rendering di date, orari e durate nella risposta. Questo valore viene ignorato se |
Corpo della risposta
La risposta quando si aggiorna un intervallo di valori in un foglio di lavoro.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
Campi | |
---|---|
spreadsheetId |
Il foglio di lavoro a cui sono stati applicati gli aggiornamenti. |
totalUpdatedRows |
Il numero totale di righe in cui è stata aggiornata almeno una cella della riga. |
totalUpdatedColumns |
Il numero totale di colonne in cui è stata aggiornata almeno una cella della colonna. |
totalUpdatedCells |
Il numero totale di celle aggiornate. |
totalUpdatedSheets |
Il numero totale di fogli in cui è stata aggiornata almeno una cella del foglio. |
responses[] |
La risposta per ogni intervallo è stata aggiornata. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Per ulteriori informazioni, consulta la guida all'autorizzazione.
DataFilterValueRange
Un intervallo di valori la cui posizione è specificata da un valore DataFilter
.
Rappresentazione JSON |
---|
{ "dataFilter": { object ( |
Campi | |
---|---|
dataFilter |
Il filtro dati che descrive la posizione dei valori nel foglio di lavoro. |
majorDimension |
La dimensione principale dei valori. |
values[] |
I dati da scrivere. Se i valori forniti superano uno qualsiasi degli intervalli corrispondenti dal filtro dati, la richiesta non riesce. Se i valori forniti sono inferiori agli intervalli corrispondenti, vengono scritti solo i valori specificati, i valori esistenti negli intervalli corrispondenti rimangono invariati. |
UpdateValuesByDataFilterResponse
La risposta quando viene aggiornato un intervallo di valori da parte di un filtro dati in un foglio di lavoro.
Rappresentazione JSON |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
Campi | |
---|---|
updatedRange |
L'intervallo (in notazione A1) a cui sono stati applicati gli aggiornamenti. |
updatedRows |
Il numero di righe in cui è stata aggiornata almeno una cella della riga. |
updatedColumns |
Il numero di colonne in cui è stata aggiornata almeno una cella della colonna. |
updatedCells |
Il numero di celle aggiornate. |
dataFilter |
Il filtro dati che ha selezionato l'intervallo aggiornato. |
updatedData |
I valori delle celle dell'intervallo corrispondenti al filtro dati dopo l'applicazione di tutti gli aggiornamenti. Questo valore viene incluso solo se il campo |