- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
- MatchedValueRange
- Pruébala
Muestra uno o más rangos de valores que coinciden con los filtros de datos especificados. El llamador debe especificar el ID de la hoja de cálculo y uno o más DataFilters
. Se mostrarán los rangos que coincidan con cualquiera de los filtros de datos de la solicitud.
Solicitud HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
spreadsheetId |
El ID de la hoja de cálculo de la que se recuperarán los datos. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "dataFilters": [ { object ( |
Campos | |
---|---|
dataFilters[] |
Los filtros de datos utilizados para hacer coincidir los rangos de valores a recuperar. Los rangos que coinciden con cualquiera de los filtros de datos especificados se incluyen en la respuesta. |
majorDimension |
Es la dimensión principal que se debe usar en los resultados. Por ejemplo, si los datos de la hoja de cálculo son |
valueRenderOption |
Cómo se deben representar los valores en el resultado. La opción de renderización predeterminada es |
dateTimeRenderOption |
Cómo se deben representar las fechas, las horas y las duraciones en el resultado Se ignora si |
Cuerpo de la respuesta
Es la respuesta cuando se recupera más de un rango de valores en una hoja de cálculo seleccionada por DataFilters
.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
Campos | |
---|---|
spreadsheetId |
El ID de la hoja de cálculo de la que se recuperaron los datos. |
valueRanges[] |
Los valores solicitados con la lista de filtros de datos que coincidieron. |
Alcances de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Para obtener más información, consulta la guía de autorización.
MatchedValueRange
Un rango de valores que coincidieron con uno o más archivadores de datos.
Representación JSON |
---|
{ "valueRange": { object ( |
Campos | |
---|---|
valueRange |
Los valores que coinciden con |
dataFilters[] |
El |