Como conectar o Google Cloud Storage
Este tutorial mostra como dar à Dattos acesso a um bucket do Google Cloud Storage, para que os processos busquem arquivos de entrada e entreguem arquivos exportados nele. Para entender a integração como um todo, veja Repositórios de arquivos: quais a Dattos conecta e como cadastrar.
O que você precisa
Acesso ao console do Google Cloud com permissão para criar contas de serviço e conceder papéis no bucket (ou alguém do time de nuvem que faça isso).
O bucket já criado.
Permissão para gerar chave de conta de serviço.
A criação de chave pode estar bloqueada na sua organização. Nas organizações do Google Cloud criadas a partir de 3 de maio de 2024, a criação de chaves de conta de serviço vem bloqueada por padrão, pela política iam.managed.disableServiceAccountKeyCreation. Se o botão de criar chave der erro, o administrador da organização no Google Cloud precisa liberar essa política para o projeto do bucket. A Dattos só se conecta ao Cloud Storage com a chave JSON.
1. Crie as pastas no bucket
No Cloud Storage, pastas são prefixos do nome dos arquivos. Para que a pasta apareça na lista da Dattos mesmo vazia, crie-a antes no console: abra o bucket na página Buckets e clique em Criar pasta. Por exemplo, dattos/entrada/extratos e dattos/saida/relatorios.
2. Crie a conta de serviço
Na página Contas de serviço do console, no projeto do bucket, crie uma conta de serviço exclusiva para a Dattos.
Abra o bucket, vá em Permissões › Conceder acesso, informe o e-mail da conta de serviço e dê o papel Storage Object User (
roles/storage.objectUser). Ele permite listar, ler, gravar e apagar arquivos, só naquele bucket, e é o menor papel que atende a Dattos.Volte à página Contas de serviço e clique no e-mail da conta criada. Na aba Chaves, abra Adicionar chave › Criar nova chave, escolha JSON e clique em Criar. O Google baixa um arquivo
.jsonpara o seu computador, e esse arquivo não pode ser baixado de novo.
A permissão de apagar é necessária porque a Dattos move os arquivos lidos para subpastas de controle (.processing, .processed e .error). No Cloud Storage, mover um arquivo é copiar e apagar o original.
3. Cadastre a credencial na Dattos
Clique no ícone de engrenagem e abra Geral › Credenciais.
Clique em + Nova credencial e, na aba Armazenamento, escolha Google Cloud Storage.
Preencha os campos:
Campo | O que informar | Obrigatório |
|---|---|---|
Nome da credencial | Um nome que identifique o bucket, como "GCS Financeiro - extratos" | Sim |
Nome do Bucket | Só o nome do bucket, sem | Sim |
JSON da Conta de Serviço | O conteúdo inteiro do arquivo | Sim |
Prefixo | Opcional. Limita a Dattos a uma parte do bucket, por exemplo | Não |
Perfis de privacidade | Quem pode usar esta credencial nos processos | Sim |
Clique em Salvar. Depois de salvo, apague o arquivo
.jsondo seu computador: a chave fica guardada na Dattos.
O Google Cloud Storage não tem o botão Testar conexão. Para conferir o acesso, siga o próximo passo.
4. Confira e ligue o bucket a um processo
Abra um processo Turbo AI com o fluxo publicado e vá em Diretório de Origem.
Clique em Editar na fonte desejada, depois em Adicionar destino.
Em Integração de Armazenamento, escolha a credencial que você criou.
Se as pastas do bucket aparecerem em Pastas de Importação, o acesso está certo. Escolha a pasta e salve.
O passo a passo completo, inclusive da saída, está em Integração com repositórios de arquivos: diretórios de origem e de saída.
Como ver os arquivos do bucket
A Dattos mostra as pastas, mas não os arquivos. Para conferir se o arquivo chegou, se foi para .processed ou para .error, ou se a exportação foi entregue, abra o bucket na página Buckets do console do Google Cloud com um usuário da sua empresa que tenha acesso de leitura.
Problemas comuns
O que você vê | Causa provável |
|---|---|
Erro ao carregar as pastas | JSON colado pela metade, chave revogada no Google Cloud, nome do bucket errado ou conta de serviço sem papel no bucket |
As pastas aparecem, mas a execução termina com erro ao gravar ou mover o arquivo | A conta de serviço tem só papel de leitura; troque por Storage Object User |
Uma pasta não aparece na lista | A pasta está fora do Prefixo informado ou ainda não foi criada no bucket |