Guía de Conexión de Google Sheets¶

Descripción General¶

Esta guía describe los requisitos del sistema y las instrucciones para conectar Vinyl a un servidor de base de datos de Google Sheets.

Este tipo de conexión admite el acceso bidireccional a los datos, incluidas las reglas comerciales de Vinyl CRUD.

Para conectar sus servidores, debe tener instalado Vinyl 3.3+.

Requisitos del Sistema¶

Servidor de Base de Datos¶

Servidor de base de datos de Google Sheets

Navegador Web del Cliente¶

• Chrome: 84+

• Firefox: 73+

• Safari: 13.0.1+

• Edge: 84+

Instrucciones de Conexión¶

Configurar Google Sheets Desde Google Console¶

1. Navegue hasta Google Console: https://console.cloud.google.com/apis/dashboard

2. Habilite la API de Google Sheets haciendo clic en "Habilitar APIs y servicios" y buscando en Google Sheets

3. Desde el panel, configure OAuth en "Credenciales"

   

4. Haga clic en "Crear credenciales" en la parte superior de la pantalla y elija "ID de cliente OAuth".

5. Elija el tipo de aplicación "Aplicación web" y asigne un nombre a su aplicación.

6. Agregue un URI de redireccionamiento autorizado al proveedor de seguridad creado a continuación.

7. Haga clic en "Crear" y tome nota del ID de cliente y el Secreto de cliente.

   

   Nota

   El URI de redireccionamiento en este ejemplo utiliza el proveedor de seguridad llamado GoogleOAuth.

Configurar Google Sheets en Vinyl¶

1. Configure el proveedor de seguridad en Vinyl navegando hasta IDE > Proveedores de seguridad

2. Agregue un proveedor de seguridad "Autenticación de fuente de datos"

3. Proporcione los siguientes detalles:

   • Nombre: cadena coincidente después de "iniciar sesión" para el URI de redireccionamiento

   • Tipo: OAuth

   • Tipo de autenticación: OAuth

   • Autenticación de cliente OAuth: Básico

   • Autenticación de recursos OAuth: Portador

   • Propietario del token: Cliente

   • Redireccionamiento en desafío: Verdadero

   • Extremos:

     • Extremo de autorización: https://accounts.google.com/o/oauth2/auth

     • Extremo del token: https://oauth2.googleapis.com/token

   • Credenciales:

     • Tipo: Cliente

     • Nombre de usuario: ID de cliente de Google Console

     • Contraseña: Secreto del cliente de Google Console

   • Propiedades:

   • Ámbitos: https://www.googleapis.com/auth/spreadsheets

     • Visita documentación de Google para obtener más orientación sobre los alcances. Se pueden agregar múltiples ámbitos, separados por un espacio.

   

4. Cree el servidor de datos de Google Sheets desde IDE > Servidores de datos > + Servidor

   • Nombre del servidor: proporcione un nombre

   • Tipo: Google Sheets

   • Nombre de archivo: UUID de la URL de la hoja de Google

     • Ejemplo: https://docs.google.com/spreadsheets/d/Spreadsheet_UUID_Here

   • Proveedor de seguridad: elija el proveedor de seguridad creado en el paso anterior

5. Haga clic en Guardar

Pruebe la Conexión¶

Haga clic en el botón Probar conexión en Pruebas.