- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- Testen!
Legt Werte in einem oder mehreren Bereichen einer Tabelle fest. Der Aufrufer muss die Tabellen-ID, einen valueInputOption
und einen oder mehrere DataFilterValueRanges
angeben.
HTTP-Anfrage
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
spreadsheetId |
Die ID der Tabelle, die aktualisiert werden soll. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "valueInputOption": enum ( |
Felder | |
---|---|
valueInputOption |
Wie die Eingabedaten interpretiert werden sollen. |
data[] |
Die neuen Werte, die auf die Tabelle angewendet werden sollen. Wenn die angegebene |
includeValuesInResponse |
Bestimmt, ob die Antwort auf die Aktualisierung die Werte der aktualisierten Zellen enthalten soll. Standardmäßig enthalten Antworten keine aktualisierten Werte. Das Feld |
responseValueRenderOption |
Bestimmt, wie Werte in der Antwort gerendert werden sollen. Die Standard-Rendering-Option ist |
responseDateTimeRenderOption |
Bestimmt, wie Datumsangaben, Uhrzeiten und Zeiträume in der Antwort dargestellt werden sollen. Dieser Wert wird ignoriert, wenn |
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 ( |
Felder | |
---|---|
spreadsheetId |
Die Tabelle, auf die die Änderungen angewendet wurden. |
totalUpdatedRows |
Die Gesamtzahl der Zeilen, in denen mindestens eine Zelle aktualisiert wurde. |
totalUpdatedColumns |
Die Gesamtzahl der Spalten, in denen mindestens eine Zelle aktualisiert wurde. |
totalUpdatedCells |
Die Gesamtzahl der aktualisierten Zellen. |
totalUpdatedSheets |
Die Gesamtzahl der Tabellenblätter, in denen mindestens eine Zelle aktualisiert wurde. |
responses[] |
Die Antwort für jeden Bereich wird aktualisiert. |
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.
DataFilterValueRange
Ein Wertebereich, dessen Position durch eine DataFilter
angegeben wird.
JSON-Darstellung |
---|
{ "dataFilter": { object ( |
Felder | |
---|---|
dataFilter |
Der Datenfilter, der den Speicherort der Werte in der Tabelle beschreibt. |
majorDimension |
Die Hauptdimension der Werte. |
values[] |
Die zu schreibenden Daten. Wenn die angegebenen Werte einen der Bereiche überschreiten, die mit dem Datenfilter übereinstimmen, schlägt die Anfrage fehl. Wenn die angegebenen Werte kleiner als die übereinstimmenden Bereiche sind, werden nur die angegebenen Werte geschrieben. Vorhandene Werte in den übereinstimmenden Bereichen bleiben davon unberührt. |
UpdateValuesByDataFilterResponse
Die Antwort, wenn ein Wertebereich in einer Tabelle durch einen Datenfilter aktualisiert wird.
JSON-Darstellung |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
Felder | |
---|---|
updatedRange |
Der Bereich (in A1-Notation), auf den die Aktualisierungen angewendet wurden. |
updatedRows |
Die Anzahl der Zeilen, in denen mindestens eine Zelle aktualisiert wurde. |
updatedColumns |
Die Anzahl der Spalten, in denen mindestens eine Zelle aktualisiert wurde. |
updatedCells |
Die Anzahl der aktualisierten Zellen. |
dataFilter |
Der Datenfilter, mit dem der aktualisierte Bereich ausgewählt wurde. |
updatedData |
Die Werte der Zellen im Bereich, die mit dem Datenfilter übereinstimmen, nachdem alle Aktualisierungen angewendet wurden. Dieser Wert wird nur eingefügt, wenn das Feld |