Google Drive: mudanças entre as edições

De Base de Conhecimentos da DataPlus Sistemas
Ir para navegação Ir para pesquisar
Vinicius (discussão | contribs)
Sem resumo de edição
Vinicius (discussão | contribs)
Sem resumo de edição
Linha 37: Linha 37:
[[Arquivo:7 - configoauth2.png|centro]]
[[Arquivo:7 - configoauth2.png|centro]]


Logo abaixo, é preciso definir o email do desenvolvedor ou responsável pela implantação do projeto
Logo abaixo, é preciso definir o email do desenvolvedor ou responsável pela implantação do projeto e prosseguir
[[Arquivo:8 - configoauth3.png|centro]]
[[Arquivo:8 - configoauth3.png|centro]]


Após isso, é só salvar, as 3 etapas adiante não precisam de muita atenção, então pode salvar todas e voltar para o painel inicial
Em escopos clique em "Adicionar ou remover escopos"
[[Arquivo:Adicionar escopos.png|centro]]


== 10° Passo - Publicar Projeto ==
Na janela que abrir ao lado direito, no campo "Adicionar escopos manualmente", digite "https://www.googleapis.com/auth/drive.file" e clique em "Adicionar à tabela"
Publicar o projeto para produção
[[Arquivo:Adicionar escopo tabela.png|centro]]
 
Com o escopo adiciona a tabela você pode visualizar que um valor nos filtros está marcado:
[[Arquivo:Escopo adicionado na tabela.png|centro]]
 
Depois disso basta clicar em atualizar e as informações do "Escopos não confidenciais vai ser atualizada":
[[Arquivo:Escopos não confidenciais.png|centro]]
 
Depois disso basta salvar e continuar até o "Resumo" e voltar ao painel inicial
 
== Passo - Publicar Projeto ==
Com o consentimento configurado basta publicar o projeto:
[[Arquivo:Publicar projeto.png|centro]]


'''Importante:
'''Importante:
A partir de 2021, o Google fez uma alteração que fará com que todos os tokens de atualização expirem após sete dias se o projeto que o criou ainda estiver em fase de teste. A solução é alterar seu projeto para produção e, em seguida, seus tokens de atualização durarão mais de sete dias.
A partir de 2021, o Google fez uma alteração que fará com que todos os tokens de atualização expirem após sete dias se o projeto que o criou ainda estiver em fase de teste. A solução é alterar seu projeto para produção e, assim seus tokens de atualização durarão mais de sete dias.
 
== 6° Passo - Biblioteca de APIs==
Após baixar o arquivo, clicar em Biblioteca
 
[[Arquivo:16 - library.png|centro]]
 
Pesquisar por "Google Drive" e ativar a API
[[Arquivo:Api google drive.png|centro]]


[[Arquivo:9 - publicarprojeto.png|centro]]
Pesquisar por Google+
[[Arquivo:17 - libraryapi.png|centro]]


== 11° Passo - Configurar credenciais ==
Selecionar Google+ API
Com o autorização do OAuth feita e com o projeto publicado, ir em Credenciais - Criar Credenciais
[[Arquivo:18 - googole+.png|centro]]
 
== Passo - Configurar credenciais ==
Com o autorização do OAuth concluída e com o projeto publicado, ir em Credenciais - Criar Credenciais


[[Arquivo:10 - configcredenciais.png|centro]]
[[Arquivo:10 - configcredenciais.png|centro]]


== 12° Passo - Criar Chave OAuth Client Id ==
Clicar em Cliente Id OAuth
Clicar em Cliente Id OAuth
[[Arquivo:11 - keyoauth.png|centro]]
[[Arquivo:11 - keyoauth.png|centro]]


== 13° Passo - Tela criação Chave OAuth ==
Definir o tipo de aplicação como "Para Computador", definir um nome e Criar
Definir o tipo de aplicação como "Para Computador", definir um nome e Criar
[[Arquivo:13_-_configketoauthnome.png|centro]]
[[Arquivo:13_-_configketoauthnome.png|centro]]


== 14° Passo - Chave Criada ==
Credenciais criadas do OAuth, basta clicar em "Download JSON"
Credenciais criadas do OAuth, basta clicar em "Download JSON"
[[Arquivo:14 - keysoauth.png|centro]]
[[Arquivo:14 - keysoauth.png|centro]]


== 15° Passo - Arquivo Json ==
Um arquivo Json com as credenciais será baixado na máquina
Um arquivo Json com as credenciais será baixado na máquina
[[Arquivo:15 - arqokeys.png|centro]]
[[Arquivo:15 - arqokeys.png|centro]]


== 16° Passo - Biblioteca de APIs==
'''Com o consentimento do OAuth configurado, as credenciais geradas e as APIs necessárias ativadas, basta ir até o ERP
Após baixar o arquivo, clicar em Biblioteca
 
[[Arquivo:16 - library.png|centro]]
 
== 17° Passo - Google+ ==
Pesquisar por Google+
 
[[Arquivo:17 - libraryapi.png|centro]]
 
== 18° Passo - Google+ API ==
Selecionar Google+ API
 
[[Arquivo:18 - googole+.png|centro]]


== 19° Passo - Ativar API ==
== Passo - Configurar no ERP ==
Clicar em Ativar API
 
[[Arquivo:19 - enablegoogle+.png|centro]]
 
== 20° Passo - API Ativada ==
Com a API Google+ ativada, basta ir até o ERP
 
[[Arquivo:20 - enablegoogle+ok.png|centro]]
 
== 21° Passo - Configurar no ERP ==
Para configurar no ERP, é preciso ir em Configurações -> Configurações de Integração
Para configurar no ERP, é preciso ir em Configurações -> Configurações de Integração


[[Arquivo:21 - erp-config.png|centro]]
[[Arquivo:21 - erp-config.png|centro]]


== 22° Passo - Formulário de Configuração ==
Ir até a aba Google Drive
Ir até a aba Google Drive
[[Arquivo:22 - configgoogledrive.png|centro]]
[[Arquivo:22 - configgoogledrive.png|centro]]


== 23° Passo - Autorizar API ==
Para autorizar a API basta clicar no botão "Autorizar API" e importar o arquivo Json que foi baixado, se uma janela do navegador abrir solicitando que você informe se o aplicativo que está solicitando é confiável, basta permitir o acesso. Após o processo de autenticação uma mensagem de sucesso será exibida, e as chaves Cliente Id, Chave Secreta, Token de acesso e Token Atualizado serão importados para a tela, é preciso que ao preencher os dados como (ClienteId, Chave Secreta, Id Pasta, Email, Token Acesso, Token Atualizado) salva-los e retornar para a tela novamente para prosseguir com a criação da pasta.
Para autorizar a API basta clicar no botão "Autorizar API" e importar o arquivo Json que foi baixado, após uma mensagem de sucesso será exibida, e as chaves Cliente Id, Chave Secreta, Token de acesso e Token Atualizado serão importados para a tela, é preciso que ao preencher os dados como (ClienteId, Chave Secreta, Id Pasta, Email, Token Acesso, Token Atualizado) salva-los e retornar para a tela novamente para prosseguir com a criação da pasta
 
[[Arquivo:23 - acessoautorizadoapi.png|centro]]
[[Arquivo:23 - acessoautorizadoapi.png|centro]]


== 24° Passo - Criar pasta ==
Para criar uma pasta que será armazenado os arquivos, o usuário pode criar manualmente no Google Drive ou pode clicar no botão, uma mensagem será exibida, permitindo o usuário criar uma pasta com nome de preferência ou com o nome padrão "DataPlus"
Para criar uma pasta que será armazenado os arquivos, o usuário pode criar manualmente no Google Drive ou pode clicar no botão, uma mensagem será exibida, permitindo o usuário criar uma pasta com nome de preferência ou com o nome padrão "DataPlus"
[[Arquivo:24 - criarpasta.png|centro]]
[[Arquivo:24 - criarpasta.png|centro]]


'''Atenção: Caso alguma mensagem de erro seja apresentada durante o processo de criação da pasta é necessário aguardar algumas horas após a ativação da API, para que ela seja liberada para uso
'''Atenção: Caso alguma mensagem de erro seja apresentada durante o processo de criação da pasta é necessário aguardar algumas horas após a ativação da API, para que ela seja liberada para uso
<br>


[[Arquivo:25 - msgerro.png|centro]]
[[Arquivo:25 - msgerro.png|centro]]

Edição das 15h19min de 20 de junho de 2023

Passo a passo de como fazer a integração no Google Drive.

Atenção: Em caso de erro de token de acesso: "Token has been revoked" Em um esforço para aumentar ainda mais a segurança da conta para usuários do Google Apps, uma alteração recente foi feita em nossa política de segurança, segundo a qual os tokens OAuth2 emitidos para acesso a determinados produtos agora serão revogados quando a senha de um usuário for alterada. Por exemplo, se um usuário perder o dispositivo e alterar a senha do Google, o e-mail e outros dados deixarão de ser sincronizados com esse dispositivo quando a senha for redefinida. Isso pode também se dar ao fato do 10° passo. Ainda não foi encontrado um método de como deixar esses tokens permanentes, pois até mesmo em ambiente de produção as chaves de acesso expiram, como forma de garantir segurança para o usuário.

1° Passo - Criar conta Gmail

Criar uma conta no Gmail, ou utilizar a existente

Acessar o link: https://console.cloud.google.com/getting-started

3° Passo - Criar um projeto

Clicar em Select Project - Para criar um projeto e depois em New Project

Nomear o projeto com o nome de preferência

4° Passo - Tela consentimento OAuth

Ir para APIS & Serviços - Tela de Consentimento OAuth

oauth
oauth

Escolha o projeto que será feito a autorização do OAuth

Com o projeto selecionado, configurar o tipo para externo

Definir um nome para o aplicativo e o email de suporte, é aconselhável que o nome do aplicativo seja o mesmo que o nome do projeto

Logo abaixo, é preciso definir o email do desenvolvedor ou responsável pela implantação do projeto e prosseguir

Em escopos clique em "Adicionar ou remover escopos"

Na janela que abrir ao lado direito, no campo "Adicionar escopos manualmente", digite "https://www.googleapis.com/auth/drive.file" e clique em "Adicionar à tabela"

Com o escopo adiciona a tabela você pode visualizar que um valor nos filtros está marcado:

Depois disso basta clicar em atualizar e as informações do "Escopos não confidenciais vai ser atualizada":

Depois disso basta salvar e continuar até o "Resumo" e voltar ao painel inicial

5° Passo - Publicar Projeto

Com o consentimento configurado basta publicar o projeto:

Importante: A partir de 2021, o Google fez uma alteração que fará com que todos os tokens de atualização expirem após sete dias se o projeto que o criou ainda estiver em fase de teste. A solução é alterar seu projeto para produção e, assim seus tokens de atualização durarão mais de sete dias.

6° Passo - Biblioteca de APIs

Após baixar o arquivo, clicar em Biblioteca

Pesquisar por "Google Drive" e ativar a API

Pesquisar por Google+

Selecionar Google+ API

7° Passo - Configurar credenciais

Com o autorização do OAuth concluída e com o projeto publicado, ir em Credenciais - Criar Credenciais

Clicar em Cliente Id OAuth

Definir o tipo de aplicação como "Para Computador", definir um nome e Criar

Credenciais criadas do OAuth, basta clicar em "Download JSON"

Um arquivo Json com as credenciais será baixado na máquina

Com o consentimento do OAuth configurado, as credenciais geradas e as APIs necessárias ativadas, basta ir até o ERP

8° Passo - Configurar no ERP

Para configurar no ERP, é preciso ir em Configurações -> Configurações de Integração

Ir até a aba Google Drive

Para autorizar a API basta clicar no botão "Autorizar API" e importar o arquivo Json que foi baixado, se uma janela do navegador abrir solicitando que você informe se o aplicativo que está solicitando é confiável, basta permitir o acesso. Após o processo de autenticação uma mensagem de sucesso será exibida, e as chaves Cliente Id, Chave Secreta, Token de acesso e Token Atualizado serão importados para a tela, é preciso que ao preencher os dados como (ClienteId, Chave Secreta, Id Pasta, Email, Token Acesso, Token Atualizado) salva-los e retornar para a tela novamente para prosseguir com a criação da pasta.

Para criar uma pasta que será armazenado os arquivos, o usuário pode criar manualmente no Google Drive ou pode clicar no botão, uma mensagem será exibida, permitindo o usuário criar uma pasta com nome de preferência ou com o nome padrão "DataPlus"

Atenção: Caso alguma mensagem de erro seja apresentada durante o processo de criação da pasta é necessário aguardar algumas horas após a ativação da API, para que ela seja liberada para uso