Google Drive
Dois nós, no grupo Google da paleta: um cuida dos arquivos e pastas, o outro do compartilhamento. Com eles um fluxo pode buscar o anexo que chegou, exportar uma planilha do Google em PDF, arquivar o relatório do dia numa pasta por mês ou dar acesso a quem precisa.
Antes de começar
Cadastre uma credencial do tipo Google Drive:
| Campo | Para quê |
|---|---|
| Chave JSON da conta de serviço | Obrigatório. É por essa conta que o fluxo age |
| Agir em nome de (e-mail) | Opcional |
O que vale para os dois nós
- Escolha a Credencial Google Drive no topo do nó.
- Operação define o que o nó faz; os campos abaixo dela mudam conforme a operação — só aparece o que aquela operação precisa.
- Os campos aceitam
{{ … }}com dados do item, então dá para percorrer uma lista de arquivos e agir em cada um. - Operações que devolvem lista emitem um item por registro; as demais emitem um item. Lista vazia segue com o item de entrada intacto.
- Na aba Config ficam Timeout (segundos) (padrão 60) e Saída do nó (Mesclar item, o padrão, ou Substituir item) — veja Ajustes do nó.
- Cada nó tem uma saída (
main).
Google Drive — Arquivos
Lista, baixa, envia e organiza arquivos e pastas. No Drive, pasta também é arquivo — por isso as duas coisas moram no mesmo nó.
Operações
| Operação | O que informar |
|---|---|
| Listar / buscar | ID da pasta, Nome contém, Trazer, Incluir itens na lixeira, Filtro avançado, Ordenar por, Máximo de itens |
| Obter metadados | ID do arquivo |
| Baixar arquivo | ID do arquivo e Propriedade binária de saída |
| Exportar (Documentos/Planilhas Google) | ID do arquivo, Formato da exportação e Propriedade binária de saída |
| Subir arquivo | Propriedade binária, ID da pasta, Nome e Metadados adicionais |
| Substituir conteúdo | ID do arquivo e Propriedade binária |
| Renomear / atualizar metadados | ID do arquivo, Nome e Metadados adicionais |
| Mover para outra pasta | ID do arquivo e ID da pasta de destino |
| Copiar | ID do arquivo, Nome e ID da pasta |
| Criar pasta | Nome, ID da pasta e Metadados adicionais |
| Mandar para a lixeira | ID do arquivo |
| Excluir definitivamente | ID do arquivo |
No ID da pasta, em branco significa o seu Meu Drive (a raiz). O campo também aceita o ID de um drive compartilhado.
Listar / buscar
Combine os campos amigáveis à vontade: Nome contém filtra pelo nome, Trazer escolhe entre arquivos e pastas, arquivos apenas ou pastas apenas, e Incluir itens na lixeira decide se o lixo entra no resultado (por padrão não entra). Se precisar de um filtro que a tela não oferece, escreva-o em Filtro avançado — ele é somado aos demais, não os substitui. Ordenar por e Máximo de itens (padrão 100) fecham a busca.
Sai um item por arquivo encontrado, com nome, ID e demais dados do Drive.
Baixar e exportar
Baixar arquivo traz o conteúdo de um arquivo comum. O conteúdo viaja no mesmo
canal de arquivos usado por RM — Gerar relatório e Ler CSV, na propriedade
que você indicar em Propriedade binária de saída (padrão data) — é ela que
o próximo nó vai ler para anexar num e-mail, por exemplo.
Documentos, Planilhas e Apresentações do Google não têm um arquivo para baixar: use Exportar e escolha o Formato da exportação — PDF, Excel (.xlsx), Word (.docx), PowerPoint (.pptx), CSV ou Texto. A extensão certa é acrescentada ao nome. Se você pedir Baixar num arquivo do Google, o nó avisa e indica a exportação.
Subir e substituir
Subir arquivo envia o conteúdo que veio no item. Indique em Propriedade binária de onde vêm os bytes; deixe o Nome em branco para reaproveitar o nome original. Substituir conteúdo troca os bytes de um arquivo que já existe, mantendo o mesmo ID e o histórico do Drive.
Se a propriedade binária escolhida não tiver conteúdo, o nó avisa — costuma ser o caso quando a tela está mostrando uma saída fixada em vez do resultado de uma execução de verdade. Execute o fluxo e tente de novo.
Organizar
Mover para outra pasta tira o arquivo das pastas atuais e o coloca no destino — ele não fica nos dois lugares. Copiar cria um novo arquivo, com o Nome e na pasta que você indicar. Criar pasta e Renomear / atualizar metadados usam o campo Nome e o Metadados adicionais (JSON), para dados como a descrição; informe pelo menos um dos dois.
Apagar
Mandar para a lixeira é reversível: o arquivo continua no Drive, na lixeira, e pode ser restaurado de lá.
Excluir definitivamente apaga o arquivo do Drive sem passar pela lixeira. Não há como recuperar. Prefira a lixeira quando houver qualquer dúvida.
Google Drive — Compartilhamento
Controla quem enxerga um arquivo ou uma pasta. Está separado do nó de arquivos justamente porque compartilhar tem alcance fora da sua casa — quem recebe e com qual nível fica visível na tela, não escondido no meio de um menu.
O campo ID do arquivo ou pasta é obrigatório em todas as operações.
| Operação | O que informar |
|---|---|
| Listar acessos | — |
| Conceder acesso | Conceder a, E-mail ou Domínio, Nível de acesso, Avisar por e-mail |
| Criar link público | Nível de acesso |
| Revogar acesso | ID da permissão |
Conceder a escolhe entre uma pessoa (e-mail), um grupo (e-mail do grupo) ou um domínio inteiro. Nível de acesso vai de Leitor a Comentarista e Editor. Avisar por e-mail manda o aviso do Google a quem recebeu; vem desligado.
Listar acessos devolve um item por acesso existente, com o ID da permissão — é esse ID que a operação Revogar pede.
Criar link público libera o arquivo para qualquer pessoa com o link, inclusive fora da sua organização, sem pedir conta nem senha. Um link compartilhado uma vez continua valendo até alguém revogá-lo. Use só quando o conteúdo puder mesmo circular.
Revogar acesso tira o acesso na hora; para devolvê-lo é preciso conceder de novo.
Veja também: Credenciais e Ações.