Guia de Conexão do Google Sheets¶

Visão Geral¶

Este guia descreve os requisitos do sistema e instruções para conectar o Vinyl a um servidor de banco de dados do Google Sheets.

Este tipo de conexão suporta acesso bidirecional aos dados, incluindo regras de negócios do Vinyl CRUD.

Para conectar seus servidores, você deve ter o Vinyl 3.3+ instalado.

Requisitos de Sistema¶

Servidor de Banco de Dados¶

Servidor de banco de dados do Google Sheets

Navegador da Web do Cliente¶

• Chrome: 84+

• Firefox: 73+

• Safari: 13.0.1+

• Edge: 84+

Instruções de Conexão¶

Configurar o Google Sheets no Console do Google¶

1. Navegue até o Console do Google: https://console.cloud.google.com/apis/dashboard

2. Ative a API do Google Sheets clicando em "Ativar APIs e serviços" e pesquisando no Google Sheets

3. No painel, configure o OAuth em "Credenciais"

   

4. Clique em "Criar credenciais" na parte superior da tela e escolha "ID do cliente OAuth"

5. Escolha o tipo de aplicativo "Aplicativo Web" e dê um nome ao seu aplicativo

6. Adicione um URI de redirecionamento autorizado de volta ao provedor de segurança criado a seguir

7. Clique em "Criar" e anote o ID do cliente e o Segredo do cliente

   

   Nota

   O URI de redirecionamento neste exemplo usa o provedor de segurança denominado GoogleOAuth.

Configurar o Google Sheets em Vinyl¶

1. Configure o provedor de segurança no Vinyl navegando até IDE > Security Providers

2. Adicione um provedor de segurança "Autenticação de fonte de dados"

3. Forneça os seguintes detalhes:

   • Nome: String correspondente após "signin-" para URI de redirecionamento

   • Tipo: OAuth

   • Tipo de autenticação: OAuth

   • Autenticação de cliente OAuth: Básica

   • Autenticação de recurso OAuth: Portador

   • Proprietário do Token: Cliente

   • Redirecionar no Desafio: Verdadeiro

   • Endpoints:

     • Endpoint de autorização: https://accounts.google.com/o/oauth2/auth

     • Endpoint do token: https://oauth2.googleapis.com/token

   • Credenciais:

     • Tipo: Cliente

     • Nome de usuário: ID do cliente do Google Console

     • Senha: Segredo do cliente do Google Console

   • Propriedades:

   • Escopos: https://www.googleapis.com/auth/spreadsheets

     • Visite documentação do Google para obter mais orientações sobre escopos. Vários escopos podem ser adicionados, separados por um espaço.

   

4. Crie um servidor de dados do Google Sheets a partir de IDE > Servidores de dados > + Servidor

   • Nome do servidor: Forneça um nome

   • Tipo: Google Sheets

   • Nome do arquivo: UUID do URL da Planilha Google

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

   • Provedor de Segurança: Escolha o Provedor de Segurança criado na etapa anterior

5. Clique em Salvar

Teste a Conexão¶

Clique no botão Testar conexão em Teste.