Method: spreadsheets.values.update

Legt Werte in einem Bereich einer Tabelle fest. Der Aufrufer 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

Bestimmt, ob die Aktualisierungsantwort die Werte der Zellen enthalten soll, die aktualisiert wurden. Standardmäßig enthalten Antworten nicht 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 (ausgenommen 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. Dies wird ignoriert, wenn responseValueRenderOption FORMATTED_VALUE ist. Die standardmäßige Renderingoption für 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.