Crear una conexión

Una conexión vincula una fuente de datos con una URL de la API de Sheet Best. Elige la fuente según los datos que necesites:

1. A partir de una URL de Google Sheets (la hoja debe compartirse mediante enlace).
2. A partir de una carpeta de Google Drive: un listado de solo lectura con los IDs, nombres y enlaces de los archivos.
3. Subiendo un archivo de hoja de cálculo a Sheet Best.

Una cuarta opción, Conectar con Drive (beta), conecta una sola hoja de cálculo privada sin hacerla pública. Es una función distinta del listado de carpetas.

Las conexiones de Google Sheets usan /sheets/<connection-id>, las carpetas de Drive usan /drives/<connection-id> y los archivos subidos usan /uploads/<connection-id>. Copia siempre la URL de conexión (Connection URL) del panel; su ID es el de la conexión de Sheet Best, no el del archivo o la carpeta de Google.

Abre el panel de Sheet Best y haz clic en + CONNECTION para empezar.

A partir de una URL de Google Sheets

1. 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.

2. Copia la URL de la hoja desde la barra de direcciones del navegador.

3. 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.

   

4. Abre los detalles (DETAILS) de la nueva conexión y copia su URL (Connection URL).

   

A partir de una carpeta de Google Drive

Usa una conexión de carpeta como catálogo de archivos en JSON. Por ejemplo, puedes usar los nombres, IDs y enlaces devueltos para crear:

• Una lista de descarga de documentos compartidos.
• Una galería de imágenes con archivos de imagen accesibles.
• Un directorio de recursos para un sitio web o una aplicación.

Los enlaces dependen de la configuración de uso compartido y del tipo de cada archivo. Comprueba que funcionen para la descarga o visualización que necesitas; los documentos nativos de Google pueden requerir otra URL de exportación o visualización.

:::note Las filas de una hoja de cálculo necesitan su propia conexión Una conexión de carpeta no lee celdas ni combina hojas de cálculo en una sola API. Para leer las filas de una hoja de cálculo, crea una conexión de Google Sheets para ella mediante su URL o el selector de hojas privadas. Cada conexión de hoja de cálculo cuenta por separado para el límite de conexiones de tu plan. :::

Tu plan debe incluir conexiones de carpetas de Google Drive. El período de prueba Starter/Free solo admite conexiones de Google Sheets. Consulta los planes y precios.

1. En Google Drive, haz clic derecho en la carpeta y selecciona Obtener enlace.

   

2. Configura el permiso de la carpeta como Cualquier persona con el enlace → Lector y copia el enlace. Los archivos que quieras listar también deben ser accesibles mediante sus permisos de uso compartido.

   

3. En el panel, elige Google Drive como origen (Connection Origin), pega el enlace de la carpeta y haz clic en CONNECT.

4. Abre los detalles (DETAILS) y copia la URL de conexión (Connection URL). Pruébala con:

   curl https://api.sheetbest.com/drives/YOUR_CONNECTION_ID

   Una carpeta con archivos devuelve sus metadatos, ordenados por nombre:

   [
     {
       "id": "GOOGLE_FILE_ID",
       "name": "product-photo.png",
       "link": "https://drive.google.com/uc?export=view&id=GOOGLE_FILE_ID"
     }
   ]

   El id devuelto es un ID de archivo de Google. No es un ID de conexión de Sheet Best ni un endpoint para las filas de esa hoja de cálculo. Una carpeta vacía y accesible devuelve [].

Una conexión de carpeta ocupa un espacio de conexión. Los archivos nuevos pueden aparecer en el listado cuando se actualice la caché, sin crear conexiones nuevas de Sheet Best. Esto no proporciona APIs de filas de hoja de cálculo para esos archivos. La salida predeterminada es un arreglo de registros; _format=index solo cambia la estructura de los mismos metadatos. Sus claves de índice no son identificadores de archivo estables; usa id para identificar un archivo.

:::caution Límites del listado El conector lista los elementos directamente contenidos en la carpeta sin recorrer subcarpetas. Actualmente solo obtiene la primera página de resultados de Google Drive, por lo que los listados grandes pueden estar incompletos. No proporciona un token de continuación ni una forma de obtener las páginas siguientes. :::

El estado Valid de una URL no confirma que Google pueda leer la carpeta. La etiqueta Read Only del formulario no mide sus permisos de uso compartido en Google. Las conexiones de carpeta son de solo lectura aunque se compartan con acceso de Editor.

Subiendo un archivo

Usa esta opción para hojas puntuales que no estén en Google Drive.

1. En el panel, elige la carga de archivos (File Upload) como origen (Connection Origin).

2. Selecciona el archivo de tu computadora en el campo File y haz clic en CONNECT.

   

3. Abre los detalles (DETAILS) y copia la URL de conexión (Connection URL).

   

Prueba tu conexión

Los siguientes ejemplos corresponden a una conexión de Google Sheets. Para un archivo subido, usa su URL copiada /uploads/<connection-id>. Para una carpeta, usa el ejemplo anterior con /drives/<connection-id>.

cURL

curl https://api.sheetbest.com/sheets/YOUR_SHEET_ID

JavaScript

fetch("https://api.sheetbest.com/sheets/YOUR_SHEET_ID")
  .then((r) => r.json())
  .then(console.log);

Python

import requests

print(requests.get('https://api.sheetbest.com/sheets/YOUR_SHEET_ID').json())

En las conexiones de hojas de cálculo, deberías recibir un arreglo de objetos, uno por fila de la hoja. Las conexiones de carpeta devuelven un registro de metadatos por cada archivo listado.

Permisos y escritura

La compatibilidad con escritura depende del tipo de conexión, los permisos de la fuente, los métodos permitidos y el plan:

• URL de Google Sheets: necesita permiso de Editor al compartir.
• Carpeta de Google Drive: solo lectura. POST, PUT, PATCH y DELETE devuelven 405 Method Not Allowed, aunque la carpeta se comparta con acceso de Editor.
• Carga de archivos: admite escritura en los datos subidos.
• Conectar con Drive: admite escritura en la hoja de cálculo cuando la cuenta de Google conectada tiene permiso de edición.

En las conexiones de hojas de cálculo, un fallo de escritura porque la hoja de origen no es editable puede devolver el código write_error. Esto es distinto de la respuesta de método no admitido de una carpeta. 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. En un plan que admita claves de API, exige un encabezado X-Api-Key editando la conexión (Edit), abriendo la configuración avanzada (Advanced Settings) y habilitando la clave de API.

Consulta todos los detalles en Autenticación.

A continuación

• Leer datos con GET
• Trabajar con pestañas
• Filtrar y consultar