Method: spreadsheets.values.update

Legt Werte in einem Bereich einer Tabelle fest. Der Aufrufer muss die Tabellen-ID, den Bereich und eine valueInputOption angeben.

HTTP-Anfrage

PUT https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
spreadsheetId

string

Die ID der Tabelle, die aktualisiert werden soll.
range

string

Die A1-Notation der zu aktualisierenden Werte.

Abfrageparameter

Parameter
valueInputOption

enum (ValueInputOption)

Wie die Eingabedaten interpretiert 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. 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.

Anfragetext

Der Anfragetext enthält eine Instanz von ValueRange.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von UpdateValuesResponse.

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.