- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- MatchingValueRange
- Testen!
Gibt einen oder mehrere Wertebereiche zurück, die den angegebenen Datenfiltern entsprechen. Der Anrufer muss die Tabellen-ID und mindestens eine DataFilters
angeben. Bereiche, die mit einem der Datenfilter in der Anfrage übereinstimmen, werden zurückgegeben.
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, die verwendet werden, um die Wertebereiche abzurufen, die abgerufen werden sollen. In der Antwort sind Bereiche enthalten, die mit einem der angegebenen Datenfilter übereinstimmen. |
majorDimension |
Die wichtigste Dimension, die mit 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 |
Wie Datum, Uhrzeit und Dauer in der Ausgabe dargestellt werden sollen. Diese wird ignoriert, wenn |
Antworttext
Die Antwort beim Abrufen mehrerer Wertebereiche in einer von DataFilters
ausgewählten Tabelle.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
Felder | |
---|---|
spreadsheetId |
Die ID der Tabelle, aus der die Daten abgerufen wurden. |
valueRanges[] |
Die angeforderten Werte wurden mit einer Liste von Datenfiltern abgeglichen, 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.
Wertebereich
Ein Wertebereich, der von einem oder mehreren Datenfiltern abgeglichen wurde.
JSON-Darstellung |
---|
{ "valueRange": { object ( |
Felder | |
---|---|
valueRange |
Die Werte, die mit |
dataFilters[] |
Die |