- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- MatchedValueRange
- Faça um teste
Retorna um ou mais intervalos de valores que correspondem aos filtros de dados especificados. O autor da chamada precisa especificar o ID da planilha e um ou mais DataFilters
. Os intervalos que corresponderem a qualquer um dos filtros de dados na solicitação serão retornados.
Solicitação HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
spreadsheetId |
O ID da planilha da qual os dados serão recuperados. |
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{ "dataFilters": [ { object ( |
Campos | |
---|---|
dataFilters[] |
Os filtros de dados usados para corresponder aos intervalos de valores a serem recuperados. Os intervalos que correspondem a qualquer um dos filtros de dados especificados são incluídos na resposta. |
majorDimension |
A dimensão principal que os resultados devem usar. Por exemplo, se os dados da planilha forem |
valueRenderOption |
Como os valores são representados na saída. A opção de renderização padrão é |
dateTimeRenderOption |
Como datas, horas e durações são representadas na saída. Isso será ignorado se |
Corpo da resposta
A resposta ao recuperar mais de um intervalo de valores em uma planilha selecionada por DataFilters
.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
Campos | |
---|---|
spreadsheetId |
O ID da planilha da qual os dados foram recuperados. |
valueRanges[] |
Os valores solicitados com a lista de filtros de dados que correspondem a eles. |
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Para mais informações, consulte o Guia de autorização.
MatchedValueRange
Um intervalo de valores que correspondeu por um ou mais filtros de dados.
Representação JSON |
---|
{ "valueRange": { object ( |
Campos | |
---|---|
valueRange |
Os valores que correspondem ao |
dataFilters[] |
O |