Method: spreadsheets.values.batchUpdate

Legt Werte in einem oder mehreren Bereichen einer Tabelle fest. Der Aufrufer muss die Tabellen-ID, eine valueInputOption und eine 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 zu aktualisierenden Tabelle.

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

Legt fest, ob die Updateantwort die Werte der aktualisierten Zellen enthalten soll. Standardmäßig enthalten die Antworten die aktualisierten Werte nicht. Das Feld updatedData in jeder der BatchUpdateValuesResponse.responses enthält die aktualisierten Werte. Wenn der zu schreibende Bereich größer als der tatsächlich geschriebene Bereich ist, enthält die Antwort alle Werte im angeforderten Bereich (ohne nachgestellte leere Zeilen und Spalten).
responseValueRenderOption

enum (ValueRenderOption)

Legt fest, wie Werte in der Antwort gerendert werden. Die Standardoption für das Rendering ist FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Legt fest, wie Datum, Uhrzeit und Dauer in der Antwort gerendert werden. Diese wird ignoriert, wenn responseValueRenderOption den Wert FORMATTED_VALUE hat. Die standardmäßige Rendering-Option „dateTime“ 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 Aktualisierungen angewendet wurden.
totalUpdatedRows

integer

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

integer

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

integer

Die Gesamtzahl der aktualisierten Zellen.
totalUpdatedSheets

integer

Gesamtzahl der Tabellenblätter, bei denen mindestens eine Zelle im Tabellenblatt aktualisiert wurde
responses[]

object (UpdateValuesResponse)

Eine UpdateValuesResponse pro angefordertem Bereich in derselben Reihenfolge wie die Anfragen.

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.