Criar uma conexão
Uma conexão associa uma planilha a uma URL de API no formato https://api.sheetbest.com/sheets/<id>. Há três formas de criá-la:
- A partir de uma URL do Google Sheets (a planilha precisa ser compartilhada por link).
- A partir de uma pasta do Google Drive: todas as planilhas da pasta ficam expostas.
- Enviando um arquivo de planilha para o Sheet Best.
Uma quarta opção, Conectar com o Drive (beta), conecta uma planilha privada sem torná-la pública.
Abra o painel do Sheet Best e clique em + CONNECTION para começar.
A partir de uma URL do Google Sheets
-
No Google Sheets, clique em Compartilhar e conceda Qualquer pessoa com o link → Leitor (ou Editor para gravações). Veja as imagens em Prepare sua planilha.
-
Copie a URL da planilha na barra de endereços do navegador.
-
No painel do Sheet Best, dê um nome à conexão, escolha Google Sheets como origem (Connection Origin), cole a URL e clique em CONNECT.
-
Abra os detalhes (DETAILS) da nova conexão e copie sua URL (Connection URL).
A partir de uma pasta do Google Drive
Use esta opção para expor todas as planilhas de uma pasta de uma vez.
-
No Google Drive, clique com o botão direito na pasta e selecione Obter link.
-
Defina a permissão da pasta como Qualquer pessoa com o link e copie o link.
-
No painel, escolha Google Drive Folder como origem (Connection Origin), cole o link da pasta e clique em CONNECT.
Enviando um arquivo
Use esta opção para planilhas avulsas que não estejam no Google Drive.
-
No painel, escolha o envio de arquivos (File Upload) como origem (Connection Origin).
-
Selecione o arquivo no seu computador no campo File e clique em CONNECT.
-
Abra os detalhes (DETAILS) e copie a URL da conexão (Connection URL).
Teste sua conexão
- cURL
- JavaScript
- Python
curl https://api.sheetbest.com/sheets/YOUR_SHEET_ID
fetch('https://api.sheetbest.com/sheets/YOUR_SHEET_ID')
.then(r => r.json())
.then(console.log);
import requests
print(requests.get('https://api.sheetbest.com/sheets/YOUR_SHEET_ID').json())
Você deve receber um array de objetos, um por linha.
Permissões e gravações
O funcionamento dos métodos de gravação (POST, PUT, PATCH, DELETE) depende do acesso à planilha de origem:
- URL do Google Sheets: precisa de compartilhamento como Editor.
- Pasta do Google Drive: precisa de acesso de Editor à pasta.
- Envio de arquivos e Conectar com o Drive: permitem gravações por padrão assim que a conexão é criada.
Se uma chamada de gravação falhar porque a planilha não é editável, a API retorna o código write_error. Veja Códigos de erro.
Proteja a API com uma chave
Por padrão, qualquer pessoa que tenha a URL da conexão pode acessá-la. Para exigir um cabeçalho X-Api-Key, edite a conexão (Edit), abra as configurações avançadas (Advanced Settings) e habilite a chave de API.
Veja os detalhes em Autenticação.