Google Drive

Visão geral

Google Drive é a solução de armazenamento em nuvem do Google para enviar, compartilhar e colaborar em arquivos de qualquer dispositivo, com busca robusta e acesso offline. Com a integração no SquadOS, seus agentes podem criar documentos e pastas, fazer upload de arquivos a partir de URLs ou conteúdo de texto, mover e copiar itens, gerenciar permissões de compartilhamento e exportar documentos do Google Workspace para formatos padrão — tudo de forma programática dentro de fluxos de automação.

• Site oficial: https://drive.google.com/
• Documentação na Composio: docs.composio.dev/toolkits/googledrive

Autenticação

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.

A autenticação é gerenciada pela Composio via fluxo OAuth padrão do Google. Ao conectar, você autoriza o acesso à sua conta Google Drive; nenhuma chave ou senha manual é necessária.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Google Drive.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso via OAuth com sua conta Google.
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Perguntas frequentes

Como configurar credenciais OAuth personalizadas do Google para o Google Drive?

Para um guia passo a passo sobre como criar e configurar suas próprias credenciais OAuth do Google com a Composio, consulte How to create OAuth2 credentials for Google Apps.

Por que estou vendo “App is blocked” ao conectar o Google Drive?

O cliente OAuth está solicitando escopos que o Google ainda não verificou para aquele cliente. Isso geralmente acontece quando você adiciona escopos além dos padrões. Remova os escopos adicionais da sua configuração de auth, ou crie seu próprio app OAuth e envie os escopos para verificação.

Por que estou recebendo o erro “Google Drive API has not been used in project”?

Ao usar credenciais OAuth personalizadas, a Google Drive API precisa estar habilitada no projeto do Google Cloud que possui essas credenciais. Ative-a no Google Cloud Console em APIs & Services, aguarde alguns minutos e tente novamente.

Por que estou recebendo “Error 400: invalid_scope”?

Os escopos solicitados são inválidos ou formatados incorretamente na URL de autorização. Verifique os valores de escopo contra a documentação de escopos OAuth do Google.

Por que a tela de consentimento OAuth mostra “Composio” em vez do meu app?

Por padrão, a tela de consentimento usa o app OAuth da Composio. Para exibir o nome e logotipo do seu próprio app, crie seu próprio app OAuth e defina uma URL de redirecionamento personalizada.

Por que estou recebendo erros 401 nas chamadas de ferramentas?

O token de acesso do usuário não é mais válido. Causas comuns: o usuário revogou o acesso, alterou a senha ou o 2FA, uma política de administrador do Workspace mudou, ou o limite de tokens de atualização do Google (~50 por conta) foi excedido. Reautenticar o usuário geralmente resolve.

Ações disponíveis

Nota

Esta integração expõe 89 ações no total. Abaixo estão as principais; a lista completa está na documentação da Composio.

Criar arquivo ou pasta

GOOGLEDRIVE_CREATE_FILE

Cria um novo arquivo ou pasta no Google Drive. Suporta tanto a criação apenas com metadados (para pastas e documentos vazios) quanto o upload de arquivo com conteúdo. Quando file_to_upload é fornecido, faz o upload dos bytes reais do arquivo; caso contrário, cria um arquivo vazio. Tipos de arquivo nativos do Google (Docs, Sheets, Forms, etc.) e pastas são criados como shells vazios quando nenhum conteúdo é fornecido; o conteúdo deve ser adicionado manualmente depois. Arquivos recém-criados são privados por padrão — defina as permissões de compartilhamento depois para colaboração.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Não	O nome do arquivo. Embora opcional, fornecer um nome significativo é fortemente recomendado. Se não especificado, o Google Drive criará o arquivo com o nome ‘Untitled’.
fields	string	Não	Lista de campos separados por vírgula a incluir na resposta.
parents	array	Não	ID da pasta do Google Drive (não o nome da pasta) onde o arquivo será criado. Deve ser uma lista com exatamente um ID de pasta. Se omitido, o arquivo é criado na raiz do My Drive.
starred	boolean	Não	Se o usuário marcou o arquivo com estrela.
mimeType	string	Não	Tipos MIME comuns para criação de arquivos no Google Drive.
description	string	Não	Uma breve descrição do arquivo.
file_to_upload	object	Não	Conteúdo opcional do arquivo para upload. Objeto FileUploadable onde name é o nome do arquivo. Se fornecido, o arquivo será criado com o conteúdo real deste upload.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar arquivo a partir de texto

GOOGLEDRIVE_CREATE_FILE_FROM_TEXT

Cria um novo arquivo no Google Drive a partir de conteúdo de texto fornecido (até 10 MB), suportando vários formatos, incluindo conversão automática para tipos do Google Workspace. Arquivos criados são privados por padrão; use uma ferramenta de compartilhamento depois para acesso colaborativo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
file_name	string	Sim	Nome desejado para o novo arquivo no Google Drive.
mime_type	string	Não	Tipo MIME para o novo arquivo, determinando como o Google Drive interpreta seu conteúdo.
parent_id	string	Não	ID da pasta pai no Google Drive. Se omitido, o arquivo é criado na raiz do My Drive. Não passe nomes de pasta — apenas IDs de pasta funcionam.
text_content	string	Sim	Conteúdo de texto simples a ser escrito no novo arquivo. Deve ser codificado em UTF-8.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar pasta

GOOGLEDRIVE_CREATE_FOLDER

Cria uma nova pasta no Google Drive, opcionalmente dentro de uma pasta pai EXISTENTE especificada pelo seu ID ou nome. A pasta pai PRECISA já existir — use GOOGLEDRIVE_FIND_FOLDER primeiro para verificar se a pasta pai existe ou encontrar o seu ID. O Google Drive permite nomes de pasta duplicados, então sempre armazene e reutilize o ID de pasta retornado por esta ação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome para a nova pasta.
parent_id	string	Não	ID ou nome exato de uma pasta pai EXISTENTE. Se omitido, a pasta é criada na raiz do Drive.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Fazer upload de arquivo

GOOGLEDRIVE_UPLOAD_FILE

Faz upload de um arquivo (máx. 5 MB) para o Google Drive, colocando-o na pasta especificada ou na raiz se nenhum ID de pasta válido for fornecido. Sempre cria um novo arquivo (nunca atualiza um existente); use GOOGLEDRIVE_EDIT_FILE para atualizar com um file_id estável. Arquivos enviados são privados por padrão.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
file_to_upload	object	Sim	Arquivo para upload no Google Drive (máx. 5 MB). Deve ser um dict com os campos: name (nome do arquivo), mimetype (tipo MIME preciso) e s3key (caminho de um objeto Composio previamente preparado).
folder_to_upload_to	string	Não	ID opcional da pasta de destino no Google Drive. IDs inválidos ou ausentes retornam silenciosamente para a raiz do Drive sem erro.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Fazer upload de arquivo a partir de URL

GOOGLEDRIVE_UPLOAD_FROM_URL

Ferramenta para buscar um arquivo de uma URL fornecida no servidor e fazer upload para o Google Drive. Use quando precisar persistir de forma confiável arquivos hospedados externamente no Drive sem downloads no lado do cliente.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome para o arquivo no Google Drive, incluindo a extensão (ex.: ‘relatorio.pdf’, ‘imagem.png’).
mime_type	string	Não	Tipo MIME de destino para o arquivo no Google Drive. Se não especificado, o Drive detecta automaticamente a partir do conteúdo.
source_url	string	Sim	URL do arquivo a baixar e enviar para o Google Drive. Deve ser uma URL acessível publicamente.
verify_ssl	boolean	Não	Se deve verificar certificados SSL ao baixar de URLs HTTPS.
source_headers	object	Não	Cabeçalhos HTTP opcionais a incluir ao baixar da source_url. Use para tokens de autenticação ou cabeçalhos específicos de CDN.
parent_folder_id	string	Não	ID da pasta pai no Google Drive. Se não especificado, o arquivo será enviado para a raiz do My Drive.
supports_all_drives	boolean	Não	Se a solicitação suporta tanto My Drives quanto drives compartilhados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Fazer upload/atualizar conteúdo de arquivo

GOOGLEDRIVE_UPLOAD_UPDATE_FILE

Ferramenta para atualizar o conteúdo de um arquivo no Google Drive fazendo upload de novo conteúdo binário. Use quando precisar substituir o conteúdo de um arquivo existente por novos dados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
fileId	string	Sim	O ID do arquivo a atualizar com novo conteúdo.
addParents	string	Não	Lista de IDs de pastas pai a adicionar, separados por vírgula.
uploadType	string	Não	O tipo de solicitação de upload: media para upload simples (somente conteúdo), multipart para metadados + conteúdo, resumable para arquivos grandes.
ocrLanguage	string	Não	Dica de idioma para processamento OCR (código ISO 639-1, ex.: ‘pt’).
removeParents	string	Não	Lista de IDs de pastas pai a remover, separados por vírgula.
file_to_upload	object	Sim	O conteúdo do arquivo a fazer upload.
supportsAllDrives	boolean	Não	Se o app suporta tanto My Drives quanto drives compartilhados.
keepRevisionForever	boolean	Não	Se deve definir o campo keepForever na nova revisão principal.
useContentAsIndexableText	boolean	Não	Se deve usar o conteúdo enviado como texto indexável para busca.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Baixar arquivo do Google Drive

GOOGLEDRIVE_DOWNLOAD_FILE

Baixa um arquivo do Google Drive pelo seu ID. Para documentos do Google Workspace (Docs, Sheets, Slides), opcionalmente exporta para um mime_type especificado. Para outros tipos de arquivo, baixa no formato nativo independentemente do mime_type.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
fileId	string	Sim	O identificador único do arquivo a baixar do Google Drive. Deve ser um ID válido do Google Drive contendo apenas caracteres alfanuméricos, hifens e sublinhados.
mime_type	string	Não	APENAS para documentos do Google Workspace (Docs, Sheets, Slides, Drawings). Especifica o formato de exportação. Não tem efeito em arquivos regulares — eles são sempre baixados no formato nativo. Se omitido para arquivos do Workspace, o padrão é PDF.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Encontrar arquivo

GOOGLEDRIVE_FIND_FILE

A ferramenta de busca abrangente do Google Drive que trata todas as necessidades de descoberta de arquivos e pastas. Use para qualquer tarefa de busca — desde pesquisas simples por nome até consultas complexas com filtros de data, tipos MIME, permissões, propriedades personalizadas, escopo de pasta e muito mais. Busca no My Drive e nos drives compartilhados com suporte completo a metadados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
q	string	Não	String de consulta para filtrar resultados de arquivos. Aceita buscas de texto simples e sintaxe completa de consulta do Google Drive (ex.: name contains 'relatorio', mimeType = 'application/pdf', modifiedTime > '2024-01-01T00:00:00').
fields	string	Não	Seletor especificando quais campos incluir na resposta. Use * para todos os campos.
spaces	string	Não	Lista de espaços para consultar, separados por vírgula. Valores suportados: drive, appDataFolder e photos.
corpora	string	Não	Especifica quais coleções de arquivos buscar: user, domain, drive ou allDrives (padrão).
driveId	string	Não	ID do drive compartilhado para buscar. Necessário quando corpora é drive.
orderBy	string	Não	Chaves de ordenação separadas por vírgula. Ascendente por padrão; adicione desc para descendente.
pageSize	integer	Não	Número máximo de arquivos a retornar por página.
folder_id	string	Não	ID de uma pasta específica para buscar. Use root para buscar na raiz do My Drive.
pageToken	string	Não	Token para continuar uma solicitação de lista anterior na próxima página.
supportsAllDrives	boolean	Não	Se o app suporta tanto My Drives quanto drives compartilhados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Encontrar pasta

GOOGLEDRIVE_FIND_FOLDER

Ferramenta para encontrar uma pasta no Google Drive pelo seu nome e, opcionalmente, uma pasta pai. Use quando precisar localizar uma pasta específica para realizar ações como criar arquivos nela ou listar seu conteúdo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
starred	boolean	Não	Defina como true para buscar pastas marcadas com estrela, ou false para as não marcadas.
name_exact	string	Não	O nome exato da pasta a buscar. A busca diferencia maiúsculas de minúsculas.
name_contains	string	Não	Uma substring para buscar dentro dos nomes de pasta. A busca não diferencia maiúsculas de minúsculas.
modified_after	string	Não	Busca pastas modificadas após uma data e hora específica (formato RFC 3339).
parent_folder_id	string	Não	O ID da pasta pai para buscar. Apenas pastas diretamente dentro desta pasta pai serão retornadas.
name_not_contains	string	Não	Uma substring a excluir dos nomes de pasta.
full_text_contains	string	Não	Uma string para buscar no nome ou descrição da pasta.
full_text_not_contains	string	Não	Uma string a excluir do nome ou descrição da pasta.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter metadados de arquivo

GOOGLEDRIVE_GET_FILE_METADATA

Ferramenta para obter os metadados de um arquivo pelo ID. Use para verificar mimeType, parents e o status trashed antes de operações destrutivas (deletar/mover/exportar), ou para confirmar mimeType='application/vnd.google-apps.document' antes de chamar ferramentas do Google Docs.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
fields	string	Não	Lista de campos separados por vírgula a incluir na resposta. Use * para retornar todos os campos disponíveis.
fileId	string	Sim	O ID do arquivo no Google Drive (uma string alfanumérica opaca), NÃO um nome de arquivo. Se você só tiver um nome de arquivo, use GOOGLEDRIVE_FIND_FILE para obter o ID primeiro.
includeLabels	string	Não	Lista de IDs de labels a incluir na parte labelInfo da resposta, separados por vírgula.
supportsAllDrives	boolean	Não	Se o app suporta tanto My Drives quanto drives compartilhados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Editar arquivo

GOOGLEDRIVE_EDIT_FILE

Atualiza um arquivo existente do Google Drive com conteúdo binário, sobrescrevendo todo o seu conteúdo com novo texto (máx. 10 MB). IMPORTANTE: Esta ação funciona apenas com arquivos que têm conteúdo binário (arquivos de texto, PDFs, imagens, etc.). NÃO suporta edição de arquivos nativos do Google Workspace (Google Docs, Sheets, Slides, etc.). Preserva o file_id original (ao contrário de GOOGLEDRIVE_UPLOAD_FILE, que cria um novo ID).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
content	string	Sim	Novo conteúdo textual para sobrescrever o arquivo existente; será codificado em UTF-8 para upload. Sobrescreve todo o corpo do arquivo — edições parciais não são possíveis.
file_id	string	Sim	ID do arquivo do Google Drive a atualizar. Funciona apenas com arquivos que têm conteúdo binário (ex.: .txt, .json, .pdf, .jpg). NÃO suporta arquivos nativos do Google Workspace.
mime_type	string	Não	Tipo MIME do conteúdo sendo enviado. Deve corresponder ao formato real do conteúdo. Não pode ser um tipo MIME do Google Workspace.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Mover arquivo

GOOGLEDRIVE_MOVE_FILE

Ferramenta para mover um arquivo de uma pasta para outra no Google Drive. Para mover de verdade (não apenas copiar o pai), sempre forneça tanto add_parents (ID da pasta de destino) quanto remove_parents (ID da pasta de origem); omitir remove_parents deixa o arquivo em várias pastas. Útil para reorganizar arquivos, incluindo Docs/Sheets recém-criados que vão padrão para a raiz do Drive.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
file_id	string	Sim	O ID do arquivo a mover.
add_parents	string	Não	O ID da pasta de destino (ex.: '1FmTIJYwTENUDXOKyNJp7OmcRBvP_6DmT'). Nomes de pasta não são aceitos.
ocr_language	string	Não	Dica de idioma para processamento OCR durante importação de imagem (código ISO 639-1).
include_labels	string	Não	Lista de IDs de labels a incluir na parte labelInfo da resposta, separados por vírgula.
remove_parents	string	Não	Lista de IDs de pastas pai para remover o arquivo, separados por vírgula. Use para especificar a pasta de origem.
supports_all_drives	boolean	Não	Se o app suporta tanto My Drives quanto drives compartilhados.
keep_revision_forever	boolean	Não	Se deve definir o campo keepForever na nova revisão principal.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Deletar arquivo

GOOGLEDRIVE_DELETE_FILE

Ferramenta para deletar permanentemente um arquivo de propriedade do usuário sem movê-lo para a lixeira. Use quando a exclusão permanente for necessária. Se o arquivo pertencer a um drive compartilhado, o usuário deve ser organizador da pasta pai.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
fileId	string	Sim	O ID do arquivo a deletar. Remove o arquivo permanentemente sem movê-lo para a lixeira.
supportsAllDrives	boolean	Não	Se o app suporta tanto My Drives quanto drives compartilhados.
enforceSingleParent	boolean	Não	Parâmetro depreciado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Copiar arquivo com opções avançadas

GOOGLEDRIVE_COPY_FILE_ADVANCED

Cria uma cópia de um arquivo e aplica quaisquer atualizações solicitadas com semântica de patch. Use quando precisar duplicar um arquivo com opções avançadas como inclusão de labels, configurações de visibilidade ou metadados personalizados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
fileId	string	Sim	O ID do arquivo a copiar.
name	string	Não	O nome do arquivo copiado. Se não fornecido, o arquivo copiado terá o mesmo nome do original, prefixado com ‘Copy of ’.
fields	string	Não	Seletor especificando quais campos incluir na resposta parcial.
parents	array	Não	Os IDs das pastas pai que conterão o arquivo. Se não especificado, o arquivo herda os pais do arquivo de origem.
starred	boolean	Não	Se o usuário marcou o arquivo com estrela.
mimeType	string	Não	O tipo MIME do arquivo.
description	string	Não	Uma breve descrição do arquivo copiado.
supportsAllDrives	boolean	Não	Se o app suporta tanto My Drives quanto drives compartilhados.
keepRevisionForever	boolean	Não	Se deve definir o campo keepForever na nova revisão principal.
ignoreDefaultVisibility	boolean	Não	Se deve ignorar as configurações de visibilidade padrão do domínio para o arquivo criado.
copyRequiresWriterPermission	boolean	Não	Se as opções de copiar, imprimir ou baixar este arquivo devem ser desabilitadas para leitores e comentaristas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Mover arquivo para lixeira

GOOGLEDRIVE_TRASH_FILE

Ferramenta para mover um arquivo ou pasta para a lixeira (exclusão suave). Use quando precisar deletar um arquivo mas quiser permitir a recuperação via GOOGLEDRIVE_UNTRASH_FILE. Esta ação é distinta da exclusão permanente e fornece um fluxo de limpeza mais seguro.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
fields	string	Não	Lista de campos separados por vírgula a incluir na resposta.
file_id	string	Sim	O ID do arquivo a mover para a lixeira.
supportsAllDrives	boolean	Não	Se o app suporta tanto My Drives quanto drives compartilhados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Esvaziar lixeira

GOOGLEDRIVE_EMPTY_TRASH

Ferramenta para deletar permanente e irreversivelmente TODOS os arquivos na lixeira do Google Drive do usuário ou de um drive compartilhado especificado. A recuperação é impossível após a execução. Afeta todos os itens na lixeira em toda a conta ou drive compartilhado, não apenas os arquivos do fluxo de trabalho atual. Forneça driveId para atingir a lixeira de um drive compartilhado específico; omita para esvaziar a lixeira raiz do usuário.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
driveId	string	Não	Se definido, esvazia a lixeira do drive compartilhado fornecido. Este parâmetro é ignorado se o item não estiver em um drive compartilhado.
enforceSingleParent	boolean	Não	Parâmetro depreciado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Exportar arquivo do Google Workspace

GOOGLEDRIVE_EXPORT_GOOGLE_WORKSPACE_FILE

Exporta um documento do Google Workspace para o tipo MIME solicitado e retorna o conteúdo exportado. Use quando precisar exportar Google Docs, Sheets, Slides, Drawings ou arquivos do Apps Script para um formato específico. Observação: o conteúdo exportado é limitado a 10 MB pela API do Google Drive.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
fileId	string	Sim	O ID do arquivo do Google Workspace a exportar. Deve ser um ID de arquivo válido para um arquivo do Google Docs, Sheets, Slides, Drawings ou Apps Script.
mimeType	string	Sim	O tipo MIME do formato solicitado para esta exportação. Formatos suportados por tipo de origem: Google Docs → DOCX, ODT, RTF, PDF, TXT, ZIP (HTML), EPUB, Markdown; Google Sheets → XLSX, ODS, PDF, CSV, TSV, ZIP (HTML); Google Slides → PPTX, ODP, PDF, TXT, JPG, PNG, SVG; Google Drawings → PDF, JPG, PNG, SVG; Apps Script → JSON.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Exportar ou baixar arquivo (depreciado)

GOOGLEDRIVE_PARSE_FILE

DEPRECIADO: Exporta arquivos do Google Workspace (máx. 10 MB) para um formato especificado usando mime_type, ou baixa outros tipos de arquivo; use GOOGLEDRIVE_DOWNLOAD_FILE em vez disso.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
file_id	string	Sim	O ID único do arquivo armazenado no Google Drive que você deseja exportar ou baixar.
mime_type	string	Não	Tipo MIME de destino para exportar arquivos do Google Workspace. Para arquivos não-Workspace, este parâmetro é ignorado e o arquivo é baixado no formato nativo.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar permissão

GOOGLEDRIVE_CREATE_PERMISSION

Ferramenta para criar uma permissão para um arquivo ou drive compartilhado. Use quando precisar compartilhar um arquivo ou pasta com usuários, grupos, domínios ou torná-lo acessível publicamente. Aviso: operações de permissões concorrentes no mesmo arquivo não são suportadas; apenas a última atualização é aplicada.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
role	string	Sim	O papel concedido por esta permissão. Valores válidos: owner, organizer, fileOrganizer, writer, commenter, reader.
type	string	Sim	O tipo do destinatário: user, group, domain ou anyone. Ao criar uma permissão, se type for user ou group, você deve fornecer email_address.
domain	string	Não	O domínio ao qual esta permissão se refere. Obrigatório quando type é domain.
file_id	string	Sim	O ID do arquivo ou drive compartilhado.
email_address	string	Não	O endereço de e-mail do usuário ou grupo ao qual esta permissão se refere. Obrigatório quando type é user ou group.
email_message	string	Não	Uma mensagem personalizada em texto simples para incluir no e-mail de notificação.
expiration_time	string	Não	O horário em que esta permissão expirará (data-hora RFC 3339). Apenas para permissões de usuário e grupo.
transfer_ownership	boolean	Não	Se deve transferir a propriedade para o usuário especificado e rebaixar o proprietário atual para escritor.
allow_file_discovery	boolean	Não	Se a permissão permite que o arquivo seja descoberto por busca. Aplicável apenas para permissões do tipo domain ou anyone.
send_notification_email	boolean	Não	Se deve enviar um e-mail de notificação ao compartilhar com usuários ou grupos.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar permissões

GOOGLEDRIVE_LIST_PERMISSIONS

Ferramenta para listar as permissões de um arquivo. Use quando precisar recuperar todas as permissões associadas a um arquivo ou drive compartilhado específico.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
fileId	string	Sim	O ID do arquivo ou drive compartilhado.
pageSize	integer	Não	O número máximo de permissões a retornar por página.
pageToken	string	Não	Token para continuar uma solicitação de lista anterior na próxima página.
supportsAllDrives	boolean	Não	Se o app suporta tanto My Drives quanto drives compartilhados.
useDomainAdminAccess	boolean	Não	Emitir a solicitação como administrador de domínio.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Deletar permissão

GOOGLEDRIVE_DELETE_PERMISSION

Deleta uma permissão de um arquivo pelo ID da permissão. A exclusão é irreversível — confirme o usuário, grupo ou tipo de permissão alvo antes de executar. IMPORTANTE: Você deve primeiro chamar GOOGLEDRIVE_LIST_PERMISSIONS para obter IDs de permissão válidos. Para revogar completamente o acesso público, a permissão do tipo anyone (compartilhamento por link) deve ser explicitamente deletada.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
file_id	string	Sim	O ID do arquivo ou drive compartilhado.
permission_id	string	Sim	O ID único da permissão a deletar. IMPORTANTE: Você DEVE primeiro chamar GOOGLEDRIVE_LIST_PERMISSIONS com o file_id para recuperar IDs de permissão válidos.
supportsAllDrives	boolean	Não	Se o app suporta tanto My Drives quanto drives compartilhados.
useDomainAdminAccess	boolean	Não	Emitir a solicitação como administrador de domínio.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar permissão

GOOGLEDRIVE_UPDATE_PERMISSION

Ferramenta para atualizar uma permissão com semântica de patch. Use quando precisar modificar uma permissão existente para um arquivo ou drive compartilhado. Permissões herdadas ou gerenciadas pelo domínio podem não ser editáveis; verifique a possibilidade de edição com GOOGLEDRIVE_LIST_PERMISSIONS antes de atualizar.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
fileId	string	Sim	O ID do arquivo ou drive compartilhado.
permission	object	Sim	O recurso de permissão a atualizar. Apenas role e expirationTime podem ser atualizados.
permissionId	string	Sim	O ID da permissão. Para permissões do tipo anyone, use 'anyone' como ID da permissão.
removeExpiration	boolean	Não	Se deve remover a data de expiração.
supportsAllDrives	boolean	Não	Se o app suporta tanto My Drives quanto drives compartilhados.
transferOwnership	boolean	Não	Se deve transferir a propriedade para o usuário especificado.
useDomainAdminAccess	boolean	Não	Emitir a solicitação como administrador de domínio.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar drives compartilhados

GOOGLEDRIVE_LIST_SHARED_DRIVES

Ferramenta para listar os drives compartilhados do usuário. Use quando precisar obter uma lista de todos os drives compartilhados acessíveis ao usuário autenticado. Os resultados podem diferir da interface web devido a políticas de administrador; listar um drive não garante acesso ao seu conteúdo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
q	string	Não	String de consulta para buscar drives compartilhados usando sintaxe de consulta do Google Drive (ex.: name contains 'ProjetoX').
pageSize	integer	Não	Número máximo de drives compartilhados a retornar por página. O valor máximo permitido é 1000.
pageToken	string	Não	Token de página para drives compartilhados.
useDomainAdminAccess	boolean	Não	Emitir a solicitação como administrador de domínio.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar drive compartilhado

GOOGLEDRIVE_CREATE_DRIVE

Ferramenta para criar um novo drive compartilhado. Use quando precisar criar programaticamente um novo drive compartilhado para colaboração ou armazenamento.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	O nome deste drive compartilhado.
hidden	boolean	Não	Se o drive compartilhado está oculto da visualização padrão.
themeId	string	Não	O ID do tema a partir do qual a imagem de fundo e a cor serão definidas.
colorRgb	string	Não	A cor deste drive compartilhado como uma string hexadecimal RGB.
requestId	string	Não	Opcional. Um ID para criação idempotente de um drive compartilhado.
backgroundImageFile	object	Não	Um arquivo de imagem e parâmetros de recorte para definir uma imagem de fundo para este drive compartilhado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar comentários

GOOGLEDRIVE_LIST_COMMENTS

Ferramenta para listar todos os comentários de um arquivo no Google Drive. Os resultados são paginados; itere usando nextPageToken até que esteja ausente para recuperar todos os comentários. A filtragem por autor, conteúdo ou outros critérios deve ser feita no lado do cliente.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
fields	string	Não	Lista de campos a incluir na resposta, separados por vírgula. Use * para incluir todos os campos.
fileId	string	Sim	O ID do arquivo.
pageSize	integer	Não	O número máximo de comentários a retornar por página.
pageToken	string	Não	Token para continuar uma solicitação de lista anterior na próxima página.
includeDeleted	boolean	Não	Se deve incluir comentários deletados. Comentários deletados não incluirão seu conteúdo original.
startModifiedTime	string	Não	O valor mínimo de modifiedTime para os comentários do resultado (data-hora RFC 3339).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar comentário

GOOGLEDRIVE_CREATE_COMMENT

Ferramenta para criar um comentário em um arquivo no Google Drive. Retorna um objeto data aninhado; extraia data.id para o identificador do comentário resultante. Omita anchor e quoted_file_content_* para comentários gerais no nível do arquivo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
anchor	string	Não	Uma string JSON definindo a região do documento à qual o comentário está ancorado.
content	string	Sim	O conteúdo em texto simples do comentário.
file_id	string	Sim	O ID do arquivo.
quoted_file_content_value	string	Não	O próprio conteúdo citado.
quoted_file_content_mime_type	string	Não	O tipo MIME do conteúdo citado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.