Gibt einen oder mehrere Wertebereiche zurück, die den angegebenen Datenfiltern entsprechen. Der Aufrufer muss die Tabellen-ID und mindestens eine DataFilters
angeben. Es werden Bereiche zurückgegeben, die mit einem der Datenfilter in der Anfrage übereinstimmen.
HTTP-Anfrage
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
spreadsheetId |
Die ID der Tabelle, aus der Daten abgerufen werden sollen. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "dataFilters": [ { object ( |
Felder | |
---|---|
dataFilters[] |
Die Datenfilter, mit denen die abzurufenden Wertebereiche abgeglichen werden. Bereiche, die mit einem der angegebenen Datenfilter übereinstimmen, werden in die Antwort aufgenommen. |
majorDimension |
Die Hauptdimension, die in den Ergebnissen verwendet werden soll. Wenn die Tabellendaten beispielsweise |
valueRenderOption |
Wie Werte in der Ausgabe dargestellt werden sollen. Die Standardoption für das Rendering ist |
dateTimeRenderOption |
Gibt an, wie Datum, Uhrzeit und Dauer in der Ausgabe dargestellt werden sollen. Dies wird ignoriert, wenn |
Antworttext
Die Antwort beim Abrufen mehrerer Wertebereiche in einer von DataFilters
ausgewählten Tabelle.
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
Felder | |
---|---|
spreadsheetId |
Die ID der Tabelle, aus der die Daten abgerufen wurden. |
valueRanges[] |
Die angeforderten Werte mit der Liste der Datenfilter, die ihnen entsprechen. |
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.
MatchedValueRange
Wertebereich, der von einem oder mehreren Datenfilern abgeglichen wurde.
JSON-Darstellung |
---|
{ "valueRange": { object ( |
Felder | |
---|---|
valueRange |
Die Werte, die der |
dataFilters[] |
Die |