Google Drive

Arquivos e pastas no Google Drive (Drive API v3)

Conectar ao Google Drive

google_drive.connect

Autentica com OAuth ou conta de serviço

Como usar

Autentica no Google Drive e guarda a conexão usada pelos demais comandos. Use OAuth (client ID, secret e refresh token, todos no cofre) para agir como um usuário, ou uma conta de serviço (JSON da chave no cofre), que no Google Workspace pode agir em nome de um usuário. Sem login interativo: funciona em robôs sem ninguém na frente.

Exemplo: Conecte com a conta de serviço GDRIVE_SA agindo como robo@empresa.com.br, em {drive}.

Campos

Campo	Tipo	Padrão	Detalhes
Autenticação *	Opção	`Conta de usuário (OAuth refresh token)`	Robôs autônomos: guarde tokens e chaves no cofre do OrchestratorOpções: Conta de usuário (OAuth refresh token), Conta de serviço
Client ID do OAuth *	Texto		Só quando «Autenticação» = «Conta de usuário (OAuth refresh token)»
Client secret do OAuth (cofre) *	Credencial do cofre		Só quando «Autenticação» = «Conta de usuário (OAuth refresh token)»
Refresh token (cofre) *	Credencial do cofre		Só quando «Autenticação» = «Conta de usuário (OAuth refresh token)»
JSON da chave da conta de serviço (cofre) *	Credencial do cofre		Só quando «Autenticação» = «Conta de serviço»
Agir como o usuário (delegação em todo o domínio)	Texto		Opcional: agir em nome de um usuário do WorkspaceEx.: `usuario@empresa.com`Só quando «Autenticação» = «Conta de serviço»
Salvar conexão na variável *	Variável de saída	`drive`

Resultado: guardado na variável drive (Objeto).

Listar Arquivos

google_drive.list_files

Lista os arquivos de uma pasta

Como usar

Lista os arquivos de uma pasta (pelo ID; root é a pasta principal), com filtro extra opcional na sintaxe do Drive. Cada item traz id, nome, tipo, tamanho e datas.

Exemplo: Liste a pasta de ID {pasta_entrada} em {files} e baixe cada arquivo.

Campos

Campo	Tipo	Padrão
Conexão do Drive *	Variável	`drive`
ID da pasta	Texto	`root`
Máximo de resultados	Número	`100`
Salvar resultado na variável *	Variável de saída	`files`

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Filtro extra (consulta do Drive)	Texto		Ex.: `mimeType = 'application/pdf'`
Incluir lixeira	Sim/Não	`Não`

Resultado: guardado na variável files (Lista).

Buscar Arquivos

google_drive.search_files

Busca arquivos por nome e tipo

Como usar

Busca arquivos no Drive todo pelo nome e tipo (pasta, PDF, planilha, documento, imagem).

Exemplo: Busque planilhas com nome contendo "Fechamento {mes}" em {files}.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Drive *	Variável	`drive`
Nome contém *	Texto
Tipo	Opção	`Qualquer`	Opções: Qualquer, Pasta, PDF, Planilha, Documento, Imagem
Máximo de resultados	Número	`100`
Salvar resultado na variável *	Variável de saída	`files`

Resultado: guardado na variável files (Lista).

Obter Arquivo pelo Caminho

google_drive.get_file_by_path

Converte um caminho como "Relatórios/2026/arquivo.xlsx" no ID do arquivo

Como usar

Descobre o ID de um arquivo ou pasta a partir do caminho legível, como Relatórios/2026/vendas.xlsx. Os outros comandos usam o ID.

Exemplo: Obtenha o ID de "Financeiro/Entrada" em {pasta_entrada}.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Drive *	Variável	`drive`
Caminho no Drive *	Texto		Ex.: `Relatórios/2026/arquivo.xlsx`
Salvar resultado na variável *	Variável de saída	`file_id`

Resultado: guardado na variável file_id (Texto).

Enviar Arquivo

google_drive.upload_file

Envia um arquivo local para uma pasta

Como usar

Envia um arquivo local para uma pasta do Drive e guarda o ID criado. Pode converter para Google Docs/Planilhas e substituir um arquivo com o mesmo nome.

Exemplo: Envie {relatorio} para a pasta {pasta_saida}, substituindo a versão anterior.

Campos

Campo	Tipo	Padrão
Conexão do Drive *	Variável	`drive`
Arquivo local *	Arquivo
ID da pasta de destino	Texto	`root`
Nome no Drive (vazio = mesmo)	Texto
Salvar resultado na variável *	Variável de saída	`file_id`

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Converter para formato Google	Sim/Não	`Não`
Substituir arquivo de mesmo nome	Sim/Não	`Não`

Resultado: guardado na variável file_id (Texto).

Baixar Arquivo

google_drive.download_file

Baixa um arquivo (Google Docs são exportados)

Como usar

Baixa um arquivo pelo ID para uma pasta local. Documentos Google são exportados (PDF, XLSX, DOCX...).

Exemplo: Baixe a planilha Google {item.id} como xlsx em C:\Robos\entrada.

Campos

Campo	Tipo	Padrão
Conexão do Drive *	Variável	`drive`
ID do arquivo *	Texto
Salvar na pasta *	Pasta
Salvar caminho do arquivo na variável *	Variável de saída	`downloaded_file`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Exportar arquivos Google como	Opção	`Automático (formato Office)`	Opções: Automático (formato Office), pdf, xlsx, docx, pptx, csv

Resultado: guardado na variável downloaded_file (Caminho de arquivo).

Criar Pasta

google_drive.create_folder

Cria uma pasta

Como usar

Cria uma pasta dentro de outra (pelo ID) e guarda o ID da nova pasta.

Exemplo: Crie a pasta "{ano}-{mes}" dentro de {pasta_relatorios}.

Campos

Campo	Tipo	Padrão
Conexão do Drive *	Variável	`drive`
Nome da pasta *	Texto
ID da pasta pai	Texto	`root`
Salvar resultado na variável *	Variável de saída	`folder_id`

Resultado: guardado na variável folder_id (Texto).

Mover Arquivo

google_drive.move_file

Move um arquivo para outra pasta

Como usar

Move um arquivo para outra pasta do Drive.

Exemplo: Mova {item.id} para a pasta {pasta_processados}.

Campos

Campo	Tipo	Padrão
Conexão do Drive *	Variável	`drive`
ID do arquivo *	Texto
ID da pasta de destino *	Texto

Copiar Arquivo

google_drive.copy_file

Copia um arquivo

Como usar

Copia um arquivo, com novo nome e pasta opcionais, e guarda o ID da cópia. Útil para gerar documentos a partir de um modelo.

Exemplo: Copie o modelo de proposta como "Proposta {cliente}" na pasta {pasta_propostas}.

Campos

Campo	Tipo	Padrão
Conexão do Drive *	Variável	`drive`
ID do arquivo *	Texto
Nome da cópia	Texto
ID da pasta de destino	Texto
Salvar resultado na variável *	Variável de saída	`new_file_id`

Resultado: guardado na variável new_file_id (Texto).

Renomear Arquivo

google_drive.rename_file

Renomeia um arquivo ou pasta

Como usar

Muda o nome de um arquivo ou pasta.

Exemplo: Renomeie {item.id} para "PROCESSADO - {item.name}".

Campos

Campo	Tipo	Padrão
Conexão do Drive *	Variável	`drive`
ID do arquivo *	Texto
Novo nome *	Texto

Excluir Arquivo

google_drive.delete_file

Move para a lixeira ou exclui definitivamente

Como usar

Manda o arquivo para a lixeira do Drive ou o exclui de vez.

Exemplo: Mova para a lixeira os arquivos temporários gerados pelo robô.

Campos

Campo	Tipo	Padrão
Conexão do Drive *	Variável	`drive`
ID do arquivo *	Texto
Excluir definitivamente	Sim/Não	`Não`

Compartilhar Arquivo

google_drive.share_file

Concede acesso a uma pessoa

Como usar

Dá acesso de leitura, comentário ou edição a um e-mail, com aviso por e-mail opcional.

Exemplo: Compartilhe o relatório com gestor@empresa.com.br como leitor.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Drive *	Variável	`drive`
ID do arquivo *	Texto
E-mail *	Texto
Permissão	Opção	`Leitor`	Opções: Leitor, Comentarista, Editor
Enviar notificação por e-mail	Sim/Não	`Não`

Obter Info do Arquivo

google_drive.get_file_info

Retorna nome, tamanho, tipo, datas e links

Como usar

Guarda as informações do arquivo: nome, tamanho, tipo, datas e links de visualização e download.

Exemplo: Obtenha as informações de {file_id} e envie {file_info.webViewLink} no e-mail.

Campos

Campo	Tipo	Padrão
Conexão do Drive *	Variável	`drive`
ID do arquivo *	Texto
Salvar resultado na variável *	Variável de saída	`file_info`

Resultado: guardado na variável file_info (Dicionário).