Para solicitar acesso somente leitura ao Google, o SaaSMaestro precisa de um cliente OAuth de um projeto do Google Cloud. Cada espaço de trabalho tem seu próprio cliente, configurado na aba Conexões de dados; um único projeto do Google Cloud pode atender todos eles.
Verifique primeiro: abra Configurações → Conexões de dados do espaço de trabalho e veja o quadro “Configuração do OAuth do Google”. Se aparecer “Configurado” ou “Configurado no .env”, isso já está feito e você pode ir direto para a conexão da sua conta do Google.
Quem pode fazer isso
Proprietários e administradores do espaço de trabalho que você está vendo. Como a mudança afeta a forma como todos no espaço de trabalho fazem login no Google, sua senha será solicitada novamente se você não a tiver digitado nos últimos 15 minutos.
Passo a passo
Clique no quadro “Configuração do OAuth do Google” na aba Conexões de dados do espaço de trabalho. A janela de configuração percorre as mesmas cinco etapas:
- Crie ou escolha um projeto do Google Cloud. Qualquer projeto serve.
- Ative três APIs: Google Analytics Admin API, Google Analytics Data API e Google Search Console API.
- Configure a tela de consentimento. Escolha “Interno” se todas as contas do Google que você vai conectar pertencerem ao seu próprio Google Workspace. Caso contrário, escolha “Externo” e, enquanto o app estiver no modo de teste, adicione cada conta do Google que você vai conectar como usuário de teste.
- Crie um cliente OAuth do tipo “Aplicativo da Web” e adicione o URI de redirecionamento exibido na janela de configuração. Use o botão Copiar para que ele corresponda exatamente.
- Cole as credenciais do cliente: o ID do cliente e a chave secreta do cliente; depois clique em “Salvar credenciais”.
Testando a configuração
- Testar credenciais verifica o ID do cliente e a chave secreta com o Google sem fazer login.
- Testar login executa o login completo com o Google e, se funcionar, conecta essa conta ao seu espaço de trabalho.
A chave secreta do cliente é armazenada criptografada. Para alterar só o ID do cliente, deixe o campo da chave secreta em branco e a chave salva será mantida. “Remover credenciais salvas” as exclui.
Erros comuns
| O Google diz | O que fazer |
|---|---|
redirect_uri_mismatch | O URI de redirecionamento no Google Cloud não corresponde exatamente. Copie-o de novo da janela de configuração, incluindo http ou https e qualquer caminho no final. |
access_denied | A tela de consentimento é Externa e está no modo de teste, e esta conta do Google não é um usuário de teste. Adicione-a aos usuários de teste da tela de consentimento. |
| API não ativada | Uma das três APIs não está ativada no projeto. Ative-a, aguarde um minuto e tente de novo. |
invalid_client | O ID do cliente ou a chave secreta está errado, ou o cliente foi excluído. Cole credenciais novas. |
A seguir: Conexão de contas do Google.