Method: spreadsheets.values.update

Legt Werte in einem Bereich einer Tabelle fest. Der Anrufer muss die Tabellen-ID, den Bereich und einen 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 zu aktualisierenden Tabelle.
range

string

Die A1-Notation der zu aktualisierenden Werte.

Abfrageparameter

Parameter
valueInputOption

enum (ValueInputOption)

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

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.