Google Workspace

Doze nós que colocam o Google dentro do fluxo: ler uma planilha linha a linha, marcar uma reunião, responder um e-mail, gerar um contrato a partir de um modelo, criar a conta do aluno, avisar a equipe numa sala do Chat, consultar o BigQuery. Todos usam a mesma credencial e cada um aparece num grupo diferente da paleta, perto dos nós com que costuma trabalhar.

Antes de começar

Cadastre uma credencial do tipo Google Workspace — é ela que todos os doze pedem. Não é a credencial "Google Drive": aquela serve apenas aos nós do Drive. São tipos separados justamente para que a lista de credenciais da tela de um nó de Agenda não ofereça a do Drive.

Uma credencial, uma liberação por serviço

A mesma credencial atende os doze nós, mas cada nó pede ao Google uma permissão diferente — a de Planilhas não vale para a Agenda, a de Documentos não vale para o Gmail. Ao ligar um nó novo, peça ao administrador do Google Workspace que libere a conta de serviço para aquele serviço (no Admin Console, em Segurança → Controles de API → Delegação em todo o domínio). Enquanto isso não é feito, a resposta do Google parece problema de credencial, mas a credencial está certa: só falta a liberação daquele serviço.

Os nós que agem em nome de uma pessoa — Gmail, Agenda, Contatos, Tarefas, Documentos — precisam do campo Agir em nome de preenchido com o e-mail da conta cuja caixa, agenda ou lista será usada. Uma conta de serviço não tem caixa de e-mail nem agenda próprias, então sem esse campo não há o que abrir. O nó de Usuários vai além: ali o e-mail tem de ser o de um administrador do domínio. Já o Chat é a exceção — ele fala como aplicativo e ignora esse campo de propósito.

Além disso, o arquivo ou a agenda precisam estar compartilhados com o e-mail da conta de serviço (planilha, documento, apresentação, agenda), e o aplicativo do Chat precisa ter sido adicionado ao espaço.

O que vale para todos os nós

• Escolha a Credencial Google Workspace 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 e agir em cada registro.
• 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) e Saída do nó (Mesclar item, o padrão, ou Substituir item) — veja Ajustes do nó.
• Cada nó tem uma saída (main).

Onde encontrar cada nó

Google Planilhas

Lê e escreve linhas de uma planilha do Google. Na leitura, cada linha vira um item e os nomes das colunas vêm da primeira linha — os nós seguintes usam {{ nome_da_coluna }} como usariam qualquer outro campo. Cada linha traz também _linha, o número real dela na planilha; é por ele que você volta depois para atualizar aquela linha.

Em Planilha cole o link inteiro ou apenas o identificador. Em Intervalo use a notação da própria planilha, com o nome da página — Vendas!A:F ou Vendas!A2:F2. Lembre de compartilhar a planilha com o e-mail da conta de serviço.

A primeira linha tem os nomes das colunas muda os dois sentidos: ao ler, cada linha vira um item com esses nomes; ao escrever, cada coluna vai para o lugar do nome correspondente, mesmo que a ordem na tela seja outra (nome que não existe na planilha vira coluna nova, à direita). Desligue e vale a ordem em que você digitou.

Em Trazer os valores escolha como os dados chegam: Como aparecem na planilha (o padrão), Sem formatação, com números e datas crus, ou A fórmula digitada na célula.

Para escrever, preencha Colunas — cada linha do quadro é uma coluna, com o valor podendo vir do item. Acrescentar insere no fim; Atualizar sobrescreve o intervalo indicado. Sai o resumo em _planilha, com o intervalo alterado e quantas linhas e células foram gravadas.

Google Documentos

Cria documentos, lê o texto de um documento e monta documento a partir de modelo, trocando marcadores por dados do fluxo.

Obter conteúdo devolve documentId, title, revisionId e o campo texto com o conteúdo legível do documento — inclusive o que está dentro de tabelas.

Criar documento aceita título com expressão (Contrato — {{ cliente }}) e devolve, além do identificador, a url para abrir o documento.

Substituir texto é o caminho do documento-modelo: em Substituições (JSON) cada chave é o texto exato procurado no documento e o valor é o que entra no lugar — só o valor aceita expressões do fluxo, porque a chave costuma ser escrita como {{nome}} e seria consumida antes de chegar ao Google. Sai substituidos, o total de ocorrências realmente trocadas: zero significa marcador que não existe no documento, e é o único jeito de perceber que a operação "deu certo" sem ter mudado nada.

Google Apresentações

Consulta uma apresentação, lê o texto de um slide e troca marcadores por dados do fluxo.

Obter apresentação devolve o título, o revisionId, o total_slides e a relação dos slides. Obter slide aceita a posição (1, 2, 3…) ou o identificador da página — a posição costuma ser o que se tem à mão, já que os identificadores são gerados pelo Google. O texto do slide sai no campo texto, incluindo o que está em tabelas e em elementos agrupados.

Substituir texto funciona como no Documentos, com o mesmo campo Substituições (JSON) e o mesmo substituidos na saída.

Google Cloud Storage

Lista, baixa e exclui arquivos de um bucket.

Em Objeto escreva o caminho completo dentro do bucket, com as barras normais (notas/2026/{{ id }}.pdf). Prefixo traz só os objetos cujo caminho começa daquele jeito, e Não entrar nas subpastas lista apenas o nível do prefixo.

O arquivo baixado viaja no mesmo canal de arquivos usado por RM — Gerar relatório e Ler CSV, na propriedade indicada em Propriedade binária de saída (padrão data) — é dela que o próximo nó lê para anexar num e-mail, por exemplo. Junto vêm os dados do objeto (nome, tipo, tamanho). A conta de serviço precisa ter acesso ao bucket.

Google Agenda

Lista, cria, atualiza e exclui eventos de uma agenda.

Em Agenda, primary é a agenda principal de quem a credencial representa; você também pode informar o e-mail de uma agenda compartilhada com a conta de serviço.

As datas podem ser escritas como 2026-08-01 14:00 ou com o fuso junto (2026-08-01T14:00:00-03:00). Quando o texto não traz fuso, vale o Fuso horário da aba Config — que já vem no horário de Brasília. É proposital: um horário sem fuso seria interpretado pelo fuso da agenda, e o evento nasceria na hora errada sem erro nenhum.

Termina em em branco faz o evento durar uma hora, ou o dia todo se Dia inteiro estiver marcado. Convidados são e-mails separados por vírgula, e Avisar os convidados por e-mail manda o aviso do Google — vem desligado.

Ao atualizar, campo em branco significa "não mexa", não "apague". Na listagem, um compromisso que se repete chega como uma ocorrência por vez dentro da janela pedida, que é o que serve para automação.

Google Contatos

Lista, busca, cria, atualiza e exclui contatos da agenda da pessoa representada pela credencial.

Buscar por em branco traz a agenda inteira; com texto, o Google devolve no máximo 30 contatos. Campos a trazer define o que vem de cada contato, na nomenclatura do Google (names, emailAddresses, phoneNumbers, organizations, addresses, biographies…).

Cada contato sai com o registro do Google mais um resumo plano — contato_id, nome, email, telefone —, para você não precisar escrever expressões aninhadas nos nós seguintes. O ID do contato aceita o identificador puro (c123…) ou no formato people/c123….

Ao atualizar, cada campo enviado substitui o conteúdo atual daquele campo no contato — preencha só o que quer trocar. Outros campos (JSON) é mesclado ao contato, para dados que não têm campo próprio na tela.

Google Tarefas

Lista, cria, conclui e exclui tarefas de uma lista.

ID da lista em branco usa a lista principal da pessoa representada. Em Vence em escreva só a data (2026-08-15): o Google guarda apenas o dia e ignora o horário. Incluir tarefas já concluídas é necessário para vê-las — concluir uma tarefa a esconde da lista.

Google Workspace — Usuários

Cria, atualiza, suspende e consulta contas de usuário do domínio. É o nó de provisionamento: criar a conta do aluno ou do professor a partir de um item vindo do RM, do DecolaEdu ou de uma planilha.

Em Agir em nome de, na credencial, use o e-mail de um administrador do domínio — o Google não responde a esse nó de outro jeito.

Usuário aceita o e-mail principal, um apelido ou o ID da conta. Na listagem, deixe Cliente em my_customer para usar o domínio do administrador da credencial; preencher Domínio substitui isso e traz só as contas daquele domínio. Filtro de busca usa a sintaxe do Google (orgUnitPath='/Alunos', email:joao*).

Ao criar, e-mail principal, nome, sobrenome e senha são obrigatórios, e a senha precisa de ao menos 8 caracteres. Nome e sobrenome vão sempre juntos: o Google grava os dois de uma vez, e mandar só um apagaria o outro. Na atualização, senha em branco mantém a senha atual. Outros campos (JSON) é mesclado ao que vai para o Google — telefones, cargo, campos personalizados.

Suspender acesso bloqueia a conta sem excluí-la, e Reativar acesso a devolve.

Gmail

Busca, lê, envia e marca mensagens de uma caixa. A caixa é a da conta indicada em Agir em nome de na credencial — sem esse campo o nó recusa antes de chamar o Google, porque não há caixa a abrir.

Em Busca escreva o mesmo que digitaria na caixa de busca do Gmail (is:unread from:financeiro@cliente.com.br); em branco, traz as mais recentes. Trazer o conteúdo de cada mensagem vem ligado: a busca sozinha devolve apenas identificadores, e é essa opção que traz remetente, assunto e texto (ao custo de uma consulta por mensagem).

Cada mensagem sai já organizada: de, para, copia, assunto, data, resumo, texto, html, anexos (nome, tipo e tamanho de cada um), labels e lida. Mensagem que só tem versão em HTML ainda assim entrega um texto sem marcação, para as condições do fluxo funcionarem.

Ao enviar, separe vários destinatários por vírgula. Remetente em branco envia como a própria caixa, e só aceita endereços que a conta pode usar. Acentos no assunto são tratados. A saída traz o id da mensagem enviada.

Google Chat

Envia mensagens para um espaço (sala) e lista os espaços disponíveis.

Aqui a conta de serviço fala como aplicativo, não como pessoa: o campo "Agir em nome de" da credencial é ignorado de propósito, e o aplicativo do Chat precisa ter sido adicionado ao espaço — sem isso o Google recusa por mais correta que a credencial esteja.

Espaço aceita o identificador (AAAAxxxxxxx) ou o nome completo (spaces/AAAAxxxxxxx). A Mensagem aceita a formatação simples do Chat (*negrito*, _itálico_, links). Responder na conversa agrupa a mensagem numa conversa existente; em branco, abre uma nova. Para cartões e outros recursos, use Mensagem avançada (JSON), que é mesclada ao que vai para o Chat.

Em Listar espaços, o Filtro usa a sintaxe do Google (por exemplo spaceType = "SPACE") e sai um item por espaço.

Google Tradutor

Traduz um campo do item para outro idioma. Só uma operação, de propósito: pegar um texto e guardar o resultado em outro campo.

Sai o campo escolhido em Guardar em, com o texto traduzido, e idioma_detectado. Este nó pede que a API Cloud Translation esteja habilitada no projeto do Google Cloud da conta de serviço.

Google BigQuery

Executa consultas e insere linhas em uma tabela.

Executar consulta emite um item por linha do resultado, com os nomes das colunas e os tipos já aplicados — número vem como número, data como data —, e não no formato posicional cru do BigQuery. Escreva em GoogleSQL, com expressões do fluxo se precisar. Conjunto de dados padrão permite não qualificar o nome das tabelas, e Região deve ser preenchida quando o conjunto de dados não está na região padrão (por exemplo southamerica-east1). Consulta que não devolve linhas (um comando de escrita, ou zero resultados) segue com o item de entrada e um resumo em _bigquery, com as linhas afetadas.

Consulta demorada é acompanhada até terminar; se estourar o tempo do nó, o aviso pede para aumentar o timeout ou reduzir o volume.

Inserir linhas grava os itens na tabela, em lotes. Linha (JSON) em branco envia os campos do próprio item (os que começam com _ ficam de fora); preenchida, manda exatamente o que você montar. Marque Ignorar campos que não existem na tabela e Gravar as linhas válidas mesmo que outras falhem conforme o caso — por padrão, nada é ignorado. A saída traz um item por item de entrada: os aceitos com _bigquery.inserido, e os recusados com _erro explicando o motivo dado pelo Google. Isso importa porque o BigQuery responde sucesso mesmo quando parte das linhas foi recusada.

Veja também: Credenciais, Google Drive e Ações.