Method: spreadsheets.values.batchUpdateByDataFilter

Legt Werte in einem oder mehreren Bereichen einer Tabelle fest. Weitere Informationen finden Sie unter Metadaten lesen, schreiben und durchsuchen.

Der Aufrufer muss die Tabellen-ID, ein valueInputOption und mindestens ein 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

string

Die ID der zu aktualisierenden Tabelle.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "valueInputOption": enum (ValueInputOption),
  "data": [
    {
      object (DataFilterValueRange)
    }
  ],
  "includeValuesInResponse": boolean,
  "responseValueRenderOption": enum (ValueRenderOption),
  "responseDateTimeRenderOption": enum (DateTimeRenderOption)
}
Felder
valueInputOption

enum (ValueInputOption)

Wie die Eingabedaten interpretiert werden sollen.
data[]

object (DataFilterValueRange)

Die neuen Werte, die auf die Tabelle angewendet werden sollen. Wenn mehrere Bereiche mit dem angegebenen DataFilter übereinstimmen, werden die angegebenen Werte auf alle diese Bereiche angewendet.
includeValuesInResponse

boolean

Gibt an, ob die Aktualisierungsantwort die Werte der aktualisierten Zellen enthalten soll. Standardmäßig enthalten Antworten nicht die aktualisierten Werte. Das Feld updatedData in jedem der BatchUpdateValuesResponse.responses enthält die aktualisierten Werte. Wenn der zu schreibende Bereich größer war als der tatsächlich geschriebene Bereich, enthält die Antwort alle Werte im angeforderten Bereich (ohne nachfolgende leere Zeilen und Spalten).
responseValueRenderOption

enum (ValueRenderOption)

Legt fest, wie Werte in der Antwort gerendert werden sollen. Die Standardoption für das Rendern 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 gleich FORMATTED_VALUE ist. Die Standardoption für die Darstellung von „dateTime“ ist SERIAL_NUMBER.

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 (UpdateValuesByDataFilterResponse)
    }
  ]
}
Felder
spreadsheetId

string

Die Tabelle, auf die die Aktualisierungen angewendet wurden.
totalUpdatedRows

integer

Die Gesamtzahl der Zeilen, in denen mindestens eine Zelle aktualisiert wurde.
totalUpdatedColumns

integer

Die Gesamtzahl der Spalten, in denen mindestens eine Zelle aktualisiert wurde.
totalUpdatedCells

integer

Die Gesamtzahl der aktualisierten Zellen.
totalUpdatedSheets

integer

Die Gesamtzahl der Tabellenblätter, in denen mindestens eine Zelle aktualisiert wurde.
responses[]

object (UpdateValuesByDataFilterResponse)

Die Antwort für jeden Bereich wurde 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 Autorisierungsleitfaden.

DataFilterValueRange

Ein Wertebereich, dessen Position durch ein DataFilter angegeben wird.

JSON-Darstellung 
{
  "dataFilter": {
    object (DataFilter)
  },
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
Felder
dataFilter

object (DataFilter)

Der Datenfilter, der den Speicherort der Werte in der Tabelle beschreibt.
majorDimension

enum (Dimension)

Die Hauptdimension der Werte.
values[]

array (ListValue format)

Die zu schreibenden Daten. Wenn die angegebenen Werte einen der Bereiche überschreiten, die vom Datenfilter abgedeckt werden, 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 unverändert.

UpdateValuesByDataFilterResponse

Die Antwort beim Aktualisieren eines Wertebereichs nach einem Datenfilter in einer Tabelle.

JSON-Darstellung 
{
  "updatedRange": string,
  "updatedRows": integer,
  "updatedColumns": integer,
  "updatedCells": integer,
  "dataFilter": {
    object (DataFilter)
  },
  "updatedData": {
    object (ValueRange)
  }
}
Felder
updatedRange

string

Der Bereich (in A1-Notation), auf den die Aktualisierungen angewendet wurden.
updatedRows

integer

Die Anzahl der Zeilen, in denen mindestens eine Zelle aktualisiert wurde.
updatedColumns

integer

Die Anzahl der Spalten, in denen mindestens eine Zelle aktualisiert wurde.
updatedCells

integer

Die Anzahl der aktualisierten Zellen.
dataFilter

object (DataFilter)

Der Datenfilter, mit dem der aktualisierte Bereich ausgewählt wurde.
updatedData

object (ValueRange)

Die Werte der Zellen im Bereich, die nach allen Aktualisierungen mit dem dataFilter übereinstimmen. Dieses Feld ist nur enthalten, wenn das Feld includeValuesInResponse der Anfrage true war.