Crear una conexión
Una conexión vincula una hoja de cálculo con una URL de API con el formato https://api.sheetbest.com/sheets/<id>. Hay tres formas de crearla:
- A partir de una URL de Google Sheets (la hoja debe compartirse mediante enlace).
- A partir de una carpeta de Google Drive: se exponen todas las hojas de la carpeta.
- Subiendo un archivo de hoja de cálculo a Sheet Best.
Una cuarta opción, Conectar con Drive (beta), conecta una hoja privada sin hacerla pública.
Abre el panel de Sheet Best y haz clic en + CONNECTION para empezar.
A partir de una URL de Google Sheets
-
En Google Sheets, haz clic en Compartir y concede Cualquier persona con el enlace → Lector (o Editor si necesitas escribir). Consulta las capturas en Prepara tu hoja.
-
Copia la URL de la hoja desde la barra de direcciones del navegador.
-
En el panel de Sheet Best, asigna un nombre a la conexión, elige Google Sheets como origen (Connection Origin), pega la URL y haz clic en CONNECT.
-
Abre los detalles (DETAILS) de la nueva conexión y copia su URL (Connection URL).
A partir de una carpeta de Google Drive
Usa esta opción para exponer todas las hojas de una carpeta a la vez.
-
En Google Drive, haz clic derecho en la carpeta y selecciona Obtener enlace.
-
Configura el permiso de la carpeta como Cualquier persona con el enlace y copia el enlace.
-
En el panel, elige Google Drive Folder como origen (Connection Origin), pega el enlace de la carpeta y haz clic en CONNECT.
Subiendo un archivo
Usa esta opción para hojas puntuales que no estén en Google Drive.
-
En el panel, elige la carga de archivos (File Upload) como origen (Connection Origin).
-
Selecciona el archivo de tu computadora en el campo File y haz clic en CONNECT.
-
Abre los detalles (DETAILS) y copia la URL de conexión (Connection URL).
Prueba tu conexión
- 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())
Deberías recibir un arreglo de objetos, uno por fila.
Permisos y escritura
El funcionamiento de los métodos de escritura (POST, PUT, PATCH, DELETE) depende del acceso a la hoja subyacente:
- URL de Google Sheets: necesita permiso de Editor al compartir.
- Carpeta de Google Drive: necesita acceso de Editor a la carpeta.
- Carga de archivos y Conectar con Drive: permiten escribir por defecto una vez creada la conexión.
Si una llamada de escritura falla porque la hoja no es editable, la API devuelve el código write_error. Consulta Códigos de error.
Protege la API con una clave
Por defecto, cualquiera que tenga la URL de conexión puede acceder a ella. Para exigir un encabezado X-Api-Key, edita la conexión (Edit), abre la configuración avanzada (Advanced Settings) y habilita la clave de API.
Consulta todos los detalles en Autenticación.