Method: spreadsheets.values.batchUpdate

Legt Werte in einem oder mehreren Bereichen einer Tabelle fest. Der Aufrufer muss die Tabellen-ID, einen valueInputOption und einen oder mehrere ValueRanges angeben.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
spreadsheetId

string

Die ID der Tabelle, die aktualisiert werden soll.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "valueInputOption": enum (ValueInputOption),
  "data": [
    {
      object (ValueRange)
    }
  ],
  "includeValuesInResponse": boolean,
  "responseValueRenderOption": enum (ValueRenderOption),
  "responseDateTimeRenderOption": enum (DateTimeRenderOption)
}
Felder
valueInputOption

enum (ValueInputOption)

Wie die Eingabedaten interpretiert werden sollen.
data[]

object (ValueRange)

Die neuen Werte, die auf die Tabelle angewendet werden sollen.
includeValuesInResponse

boolean

Bestimmt, ob die Antwort auf die Aktualisierung die Werte der aktualisierten Zellen enthalten soll. Standardmäßig enthalten Antworten keine aktualisierten Werte. Das Feld updatedData in jedem BatchUpdateValuesResponse.responses enthält die aktualisierten Werte. Wenn der zu schreibende Bereich größer als der tatsächlich geschriebene Bereich war, enthält die Antwort alle Werte im angeforderten Bereich (ohne leere Zeilen und Spalten am Ende).
responseValueRenderOption

enum (ValueRenderOption)

Bestimmt, wie Werte in der Antwort gerendert werden sollen. Die Standard-Rendering-Option ist FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Bestimmt, wie Datumsangaben, Uhrzeiten und Zeiträume in der Antwort dargestellt werden sollen. Dieser Wert wird ignoriert, wenn responseValueRenderOption FORMATTED_VALUE ist. Die Standardoption für die dateTime-Darstellung ist SERIAL_NUMBER.

Antworttext

Die Antwort beim Aktualisieren eines Wertebereichs in einer Tabelle.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "spreadsheetId": string,
  "totalUpdatedRows": integer,
  "totalUpdatedColumns": integer,
  "totalUpdatedCells": integer,
  "totalUpdatedSheets": integer,
  "responses": [
    {
      object (UpdateValuesResponse)
    }
  ]
}
Felder
spreadsheetId

string

Die Tabelle, auf die die Änderungen angewendet wurden.
totalUpdatedRows

integer

Die Gesamtzahl der Zeilen, in denen mindestens eine Zelle aktualisiert wurde.
totalUpdatedColumns

integer

Die Gesamtzahl der Spalten, in denen mindestens eine Zelle aktualisiert wurde.
totalUpdatedCells

integer

Die Gesamtzahl der aktualisierten Zellen.
totalUpdatedSheets

integer

Die Gesamtzahl der Tabellenblätter, in denen mindestens eine Zelle aktualisiert wurde.
responses[]

object (UpdateValuesResponse)

Eine UpdateValuesResponse pro angefordertem Bereich in der Reihenfolge, in der die Anfragen gesendet wurden.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.