Neste artigo, mostraremos como criar seu próprio projeto no Google Cloud Console e um cliente OAuth personalizado. Isso é útil para conectar serviços restritos do Google, como Google Drive ou Gmail, ao Toolzz Connect.
❗ Observação
O seguinte procedimento destina-se a:
Uso pessoal ( usuários @gmail.com e @googlemail.com )
Uso interno ( usuários do Google Workspace - anteriormente GSuite - que preferem usar um cliente OAuth personalizado)
Pré-requisitos:
uma conta do Google
Siga estas etapas para criar um cliente OAuth personalizado para os serviços do Google:
❗ Observação
Você não será cobrado ao selecionar esta opção. Para obter mais detalhes, consulte Exceções do Google aos requisitos de verificação.
Para a seção Escopos:
Clique no botão "Adicionar ou remover" escopos para adicionar os escopos necessários.
Escopos para APIs do Google | Insira os escopos necessários para o serviço do Google que você deseja conectar ao Toolzz Connect marcando a caixa correspondente para cada escopo necessário. Em seguida, clique em "Update".
 |
SERVIÇO/API | ESCOPOS REQUERIDOS |
Gmail | https://mail.google.com/ https://www.googleapis.com/auth/gmail.labels https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.insert https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.metadata |
Google Drive | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.readonly |
Para a seção Usuários de teste:
❗ Observação
A seção "Informações opcionais" é exibida apenas para usuários que não são do Google Workspace e não contém nenhum campo obrigatório.
⚠️ Aviso
Esta etapa é necessária, caso contrário, você não conseguirá estabelecer uma conexão com o Toolzz Connect.
Clique em "Add users" para adicionar o endereço de e-mail associado à conta do Google que você deseja conectar ao Toolzz Connect.
Passo a passo:
1º passo: faça login no Google Cloud Platform usando suas credenciais do Google.
2º passo: acesse o "Dashboard" e clique no botão "Create project".
3º passo: escolha um nome para o seu projeto e clique em "Create"
4º passo: clique "Enable APIS and services".
5º passo: no campo abaixo, insira o nome do serviço que deseja usar (por exemplo, API do Gmail ou API do Google Drive).
6º passo: a opção de serviço desejada deve ser exibida conforme você digita. Clique na API/serviço que deseja conectar ao Toolzz Connect.
7º passo: clique em "Enable".
8º passo: no menu lateral, clique em "APIs & Services" e escolha a opção "OAuth consent screen".
9º passo: escolha a opção "External" e clique em "Create".
10º passo: preencha os campos obrigatórios da seguinte forma:
Para a seção da tela de consentimento OAuth:
Nome da Aplicação | Digite o nome do aplicativo solicitando consentimento. Por exemplo, Toolzz Connect. |
E-mail de suporte ao usuário | Selecione seu e-mail. |
domínios autorizados | toolzzconnect.com |
Informações de contato do desenvolvedor | Digite seu e-mail. |
11º passo: abra a página de configurações de "Credentials".
❗ Observação
Caso esta não seja a primeira API/SERVIÇO (Gmail ou Google Drive) que você ativou, não é necessário criar credenciais, pois você já criou as credenciais anteriormente.
12º passo: clique em "Create credentials" e selecione a opção " OAuth client ID".
13º passo: preencha os campos obrigatórios da seguinte forma e depois clique em Criar.
Tipo de aplicação | Web application |
Nome | por exemplo, Toolzz Connect |
URIs de redirecionamento autorizado | Adicione um dos seguintes URIs:
|
14º passo: uma caixa de diálogo contendo o ID do cliente e o segredo do cliente do aplicativo é exibida.
15º passo: vá para o cenário Toolzz Connect e escolha o módulo do Google que deseja usar.
16º passo: ao lado de "Connection", clique em "Add".
17º passo: clique em "Show advanced settings".
18º passo: digite a ID do cliente e o segredo do cliente que você obteve em umas das etapas acima nos respectivos campos e clique em "Save".
Após finalizar as configurações necessárias você deverá entrar na sua conta do Google e seguir o passo a passo abaixo:
1º passo: entre com sua conta do Google.
2º passo: a janela "This app isn't verified" será exibida.
❗ Observação
O aplicativo = seu cliente OAuth que você criou acima.
3º passo: clique em "Advanced" e, em seguida, no link Go to Toolzz Connect (unsafe) para permitir o acesso usando seu cliente OAuth personalizado.
4º passo: clique em "Allow" para conceder permissão "create".
5º passo: Clique em "Allow" para confirmar suas escolhas.
Pronto! Agora você estabeleceu a conexão com o serviço do Google desejado usando um cliente OAuth personalizado.