- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos 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 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 que se usan para hacer coincidir los rangos de valores que se recuperarán. Los rangos que coinciden con cualquiera de los filtros de datos especificados se incluyen en la respuesta. |
majorDimension |
Es la dimensión principal que deberían utilizar los resultados. Por ejemplo, si los datos de la hoja de cálculo son los siguientes: |
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, horas y duraciones en los resultados. Se ignora si |
Cuerpo de la respuesta
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 desde la que se recuperaron los datos. |
valueRanges[] |
Los valores solicitados con la lista de filtros de datos que coincidieron con ellos. |
Permisos 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.
Rango de valores coincidentes
Un rango de valores que coincide con uno o más archivadores de datos.
Representación JSON |
---|
{ "valueRange": { object ( |
Campos | |
---|---|
valueRange |
Los valores que coinciden con |
dataFilters[] |
El |