Pular para o conteúdo principal

Trabalhar com abas

Por padrão, cada requisição opera na primeira aba da planilha. Para selecionar outra, acrescente /tabs/<TabName> como prefixo do caminho da operação.

Isso funciona com todas as operações: leituras, gravações, filtros, consultas e paginação.

Ler uma aba​

curl 'https://api.sheetbest.com/sheets/<api-id>/tabs/Admin'

Gravar em uma aba​

curl 'https://api.sheetbest.com/sheets/<api-id>/tabs/Admin' \
  -H 'Content-Type: application/json' \
  -d '[{"Name": "Jack Doe", "Age": 97}]'

O mesmo prefixo se aplica a PATCH, PUT e DELETE.

Combinar abas com filtros e consultas​

Os caminhos das abas se combinam com os sufixos de filtros e consultas. Coloque /tabs/<TabName> logo depois do ID da planilha:

# Filter the Admin tab by Name containing "Arthur"
curl 'https://api.sheetbest.com/sheets/<api-id>/tabs/Admin/Name/*Arthur*'

# Multi-column search inside the Admin tab
curl 'https://api.sheetbest.com/sheets/<api-id>/tabs/Admin/search?Age=21&Name=*Mick*'

Veja Filtrar dados e Consultas avançadas para conhecer os operadores disponíveis.

Nomes de abas com espaços​

Codifique para URL os nomes de abas que contenham espaços ou caracteres especiais. Por exemplo, acesse uma aba chamada Sales 2024 por /tabs/Sales%202024.

Abas nas ferramentas MCP​

As ferramentas de linhas do Sheet Best MCP aceitam um argumento tab em vez de um caminho de URL. Omita-o para usar a primeira aba ou passe o nome exato de outra. Veja Conexões e ferramentas MCP.