Method: spreadsheets.values.batchUpdate

Imposta i valori in uno o più intervalli di un foglio di lavoro. L'utente che chiama deve specificare l'ID del foglio di lavoro, un valueInputOption e uno o più ValueRanges.

Richiesta HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdate

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
spreadsheetId

string

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 (ValueInputOption),
  "data": [
    {
      object (ValueRange)
    }
  ],
  "includeValuesInResponse": boolean,
  "responseValueRenderOption": enum (ValueRenderOption),
  "responseDateTimeRenderOption": enum (DateTimeRenderOption)
}
Campi
valueInputOption

enum (ValueInputOption)

Come devono essere interpretati i dati di input.
data[]

object (ValueRange)

I nuovi valori da applicare al foglio di lavoro.
includeValuesInResponse

boolean

Determina se la risposta all'aggiornamento deve includere i valori delle celle aggiornate. Per impostazione predefinita, le risposte non includono i valori aggiornati. Il campo updatedData all'interno di ogni BatchUpdateValuesResponse.responses contiene i valori aggiornati. Se l'intervallo da scrivere era più grande dell'intervallo effettivamente scritto, la risposta include tutti i valori nell'intervallo richiesto (escluse le righe e le colonne vuote finali).
responseValueRenderOption

enum (ValueRenderOption)

Determina la modalità di visualizzazione dei valori nella risposta. L'opzione di rendering predefinita è FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Determina la modalità di visualizzazione di date, ore e durate nella risposta. Questo valore viene ignorato se responseValueRenderOption è FORMATTED_VALUE. L'opzione di visualizzazione predefinita per dateTime è SERIAL_NUMBER.

Corpo della risposta

La risposta all'aggiornamento di 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 (UpdateValuesResponse)
    }
  ]
}
Campi
spreadsheetId

string

Il foglio di lavoro a cui sono stati applicati gli aggiornamenti.
totalUpdatedRows

integer

Il numero totale di righe in cui è stata aggiornata almeno una cella.
totalUpdatedColumns

integer

Il numero totale di colonne in cui è stata aggiornata almeno una cella.
totalUpdatedCells

integer

Il numero totale di celle aggiornate.
totalUpdatedSheets

integer

Il numero totale di fogli in cui è stata aggiornata almeno una cella.
responses[]

object (UpdateValuesResponse)

Un messaggio UpdateValuesResponse per ogni intervallo richiesto, nello stesso ordine in cui sono state visualizzate le richieste.

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.