Consultar dados
O endpoint /query permite comparar valores de colunas usando um pequeno conjunto de operadores. Use-o para comparar números ou datas; para buscar texto com curingas, veja Filtros.
Operadores
| Operador | Significado | Exemplo |
|---|---|---|
__eq() | Igual a | ?Id=__eq(1) |
__ne() | Diferente de | ?Id=__ne(5) |
__lt() | Menor que | ?Amount=__lt(5.75) |
__lte() | Menor ou igual a | ?Amount=__lte(5.75) |
__gt() | Maior que | ?Created Date=__gt(8/01/2021) |
__gte() | Maior ou igual a | ?Created Date=__gte(8/01/2021) |
O valor do operador fica entre parênteses. Os operadores se aplicam a colunas numéricas e de datas.
Consultas de uma coluna
- cURL
- JavaScript
- Python
# Amount greater than 5.75
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Amount=__gt(5.75)'
# Hire Date earlier than 7/01/2021
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Hire Date=__lt(7/01/2021)'
fetch(
'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Amount=__gt(5.75)'
);
fetch(
'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Hire Date=__lt(7/01/2021)'
);
import requests
requests.get(
'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query',
params={'Amount': '__gt(5.75)'},
)
requests.get(
'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query',
params={'Hire Date': '__lt(7/01/2021)'},
)
Várias colunas
Combine vários parâmetros na mesma URL /query. Todas as condições precisam ser atendidas. Os curingas de Filtros funcionam junto com os operadores.
- cURL
- JavaScript
- Python
# Amount >= 1000 AND Age <= 56
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Amount=__gte(1000)&Age=__lte(56)'
# Name contains "Jane", Age >= 21, Hire Date before 7/01/2020
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Name=*Jane*&Age=__gte(21)&Hire Date=__lt(7/01/2020)'
# Amount < 500 AND Customer Email starts with "L"
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Amount=__lt(500)&Customer%20Email=L*'
fetch(
'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Amount=__gte(1000)&Age=__lte(56)'
);
fetch(
'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Name=*Jane*&Age=__gte(21)&Hire Date=__lt(7/01/2020)'
);
import requests
requests.get(
'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query',
params={'Amount': '__gte(1000)', 'Age': '__lte(56)'},
)
requests.get(
'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query',
params={
'Name': '*Jane*',
'Age': '__gte(21)',
'Hire Date': '__lt(7/01/2020)',
},
)
Valores vazios
Para encontrar linhas com um valor vazio em uma coluna, deixe o valor em branco:
# Rows where Name is empty
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Name='
Para colunas numéricas ou de datas, use None:
# Rows where Created at is empty (date column)
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Created%20at=None'
Dicas
- Codifique nomes de colunas com espaços para uso em URLs (
Customer%20Email) quando necessário; os clientes HTTP normalmente fazem isso por você. - As datas seguem o formato da sua planilha (por exemplo,
7/01/2021). - Para buscar texto contido sem operadores de comparação, use Filtros e sua sintaxe de curingas.