Saltar al contenido principal

Preguntas frecuentes

¿Qué es Sheet Best?​

Sheet Best convierte una hoja de Google Sheets en una API REST. Cada conexión proporciona un endpoint HTTPS con el que puedes leer, escribir, actualizar y eliminar filas mediante solicitudes HTTP estándar.

¿Cómo empiezo?​

Conecta una hoja de Google Sheets, copia la URL de la API y empieza a realizar solicitudes. Encontrarás el procedimiento completo en la guía rápida.

¿Puede un asistente de IA trabajar con mis conexiones de Sheet Best?​

Sí. Sheet Best ofrece un servidor MCP remoto que permite a clientes de IA compatibles listar o crear conexiones, consultar permisos y trabajar con filas. MCP utiliza un token de portador independiente que gestionas en la configuración de la cuenta. Empieza por la introducción a MCP.

¿Necesito una clave de API?​

Las claves de API son opcionales. De forma predeterminada, cualquiera que tenga la URL puede acceder al endpoint. Para exigir autenticación, activa la clave en Connection → Advanced Settings (Conexión → Configuración avanzada) y envíala en todas las solicitudes mediante la cabecera X-Api-Key. Consulta claves de API.

¿Cuál es la diferencia entre filtrado y consultas?​

  • El filtrado busca coincidencias de texto en los valores de las columnas. Puedes filtrar mediante la ruta de la URL (/Name/John) o el endpoint /search y usar * como comodín.
  • Las consultas usan operadores en el endpoint /query para comparar números y fechas, por ejemplo ?Age=__gt(18).

Usa filtrado para coincidencias de texto y consultas para rangos y comparaciones.

¿Cómo actualizo o elimino una fila?​

Usa PATCH (actualización parcial) o PUT (sustitución); consulta actualizar filas. Usa DELETE para eliminar filas; consulta eliminar filas. Puedes seleccionar filas por índice o coincidencia de columna.

¿Las respuestas están paginadas?​

Sheet Best no pagina las respuestas automáticamente. Usa los parámetros _limit y _offset para recorrer hojas grandes. Consulta paginación.

¿Por qué los números se devuelven como cadenas de texto?​

Los valores de las celdas se devuelven como cadenas de texto para conservar su formato. Añade _raw=1 a cualquier solicitud GET para recibir tipos nativos (números, booleanos). Consulta formatos de datos.

¿Puedo mantener mi hoja privada?​

Sí. Usa Connect with Drive (Conectar con Drive) para autorizar a Sheet Best a acceder a una hoja que no esté compartida con «Cualquier persona con el enlace». Consulta hojas privadas.

¿Qué ocurre cuando agoto mi plan?​

Cuando X-RateLimit-Remaining llega a 0, las solicitudes devuelven 402 Payment Required con el código de error throttle. Amplía tu plan para continuar.

¿Cuáles son los límites de uso?​

La cuota mensual de solicitudes depende de tu plan. Consulta X-RateLimit-Limit y X-RateLimit-Remaining en cualquier respuesta o visita la página de precios.

¿Sheet Best funciona con varias pestañas?​

Sí. Añade el nombre de la pestaña a la URL: https://api.sheetbest.com/sheets/<id>/tabs/<TabName>. Consulta pestañas.

¿Puedo llamar a Sheet Best desde el navegador?​

Sí, pero si has activado una clave de API, cualquiera que inspeccione el tráfico de red podrá verla. Para endpoints protegidos, llama a la API desde un servidor que controles.