- 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 mindestens einen 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 zu aktualisierenden Tabelle. |
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 mehr als ein Bereich mit dem angegebenen |
includeValuesInResponse |
Bestimmt, ob die Aktualisierungsantwort die Werte der Zellen enthalten soll, die aktualisiert wurden. Standardmäßig enthalten Antworten nicht die aktualisierten Werte. Das Feld |
responseValueRenderOption |
Legt fest, wie Werte in der Antwort gerendert werden. Die Standardoption für das Rendering ist |
responseDateTimeRenderOption |
Legt fest, wie Datum, Uhrzeit und Dauer in der Antwort gerendert werden. Dies wird ignoriert, wenn |
Antworttext
Die Antwort beim Aktualisieren eines Wertebereichs in einer Tabellenkalkulation.
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
Felder | |
---|---|
spreadsheetId |
Tabelle, auf die die Aktualisierungen angewendet wurden |
totalUpdatedRows |
Die Gesamtzahl der Zeilen, in denen mindestens eine Zelle in der Zeile aktualisiert wurde. |
totalUpdatedColumns |
Die Gesamtzahl der Spalten, in denen mindestens eine Zelle in der Spalte aktualisiert wurde. |
totalUpdatedCells |
Die Gesamtzahl der aktualisierten Zellen. |
totalUpdatedSheets |
Die Gesamtzahl der Tabellenblätter, in denen mindestens eine Zelle des Tabellenblatts aktualisiert wurde. |
responses[] |
Die Antwort für jeden aktualisierten Bereich. |
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 Standort durch DataFilter
angegeben wird.
JSON-Darstellung |
---|
{ "dataFilter": { object ( |
Felder | |
---|---|
dataFilter |
Der Datenfilter, der die Position der Werte in der Tabelle beschreibt. |
majorDimension |
Die Hauptdimension der Werte. |
values[] |
Die Daten, die geschrieben werden sollen. Wenn die angegebenen Werte einen der vom Datenfilter übereinstimmenden Bereiche überschreiten, 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 beim Aktualisieren eines Wertebereichs durch einen Datenfilter in einer Tabellenkalkulation.
JSON-Darstellung |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
Felder | |
---|---|
updatedRange |
Der Bereich (in A1-Notation), auf den Aktualisierungen angewendet wurden. |
updatedRows |
Die Anzahl der Zeilen, in denen mindestens eine Zelle in der Zeile aktualisiert wurde. |
updatedColumns |
Die Anzahl der Spalten, in denen mindestens eine Zelle in der Spalte 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 nach allen Aktualisierungen vom dataFilter abgeglichen wurden. Dies ist nur enthalten, wenn das Feld |