Listar arquivos · Google Drive
Listar arquivos usando a conexão Google Drive deste workspace.
O que faz
Listar arquivos usando a conexão Google Drive deste workspace.
Quando usar: Use quando o seu fluxo precisar Listar arquivos usando a conexão Google Drive deste workspace..
Exemplo de situação: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.
Antes de começar
Conexão necessária: OAuth.
Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
Passo a passo
- Adicione Listar arquivos · Google Drive ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
- Revise a ação principal descrita no cartão do bloco.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Listar arquivos | Lista arquivos com o bloco Listar arquivos · Google Drive. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Listar arquivos
- Padrão:
- Listar arquivos
Conta do Google Drive
ObrigatórioSeleciona a conta já conectada que autoriza o acesso ao serviço.
- Exemplo:
- (escolha a conta conectada)
Conta do Google Drive
ObrigatórioEm campos adicionaisInforma manualmente a credencial usada pela integração no modo avançado.
Conta representada
E-mail do usuário a representar (para contas de serviço).
- Exemplo:
- cliente@exemplo.com
Selecionar pasta
Selecione a pasta cujos arquivos serão listados.
- Aparece em:
- Listar arquivos
- Exemplo:
- (escolha na lista do campo)
ID da pasta
Em campos adicionaisInforme o ID da pasta (deixe vazio para a pasta raiz).
- Aparece em:
- Listar arquivos
- Exemplo:
- id-do-recurso
Consulta de busca
Informa a consulta usada para localizar ou transformar dados.
- Aparece em:
- Listar arquivos
- Exemplo:
- SELECT * FROM clientes WHERE status = 'ativo'
Resultados por página
Número de resultados (padrão: 100, máximo: 100).
- Aparece em:
- Listar arquivos
- Exemplo:
- 10
Token da página
Em campos adicionaisToken vindo de um nextPageToken anterior.
- Aparece em:
- Listar arquivos
- Exemplo:
- Token vindo de um nextPageToken anterior
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <listararquivosgoogledrive.file>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<listararquivosgoogledrive.file> | file | Arquivo baixado, guardado nos arquivos da execução. |
<listararquivosgoogledrive.files> | json | Lista de arquivos. |
<listararquivosgoogledrive.metadata> | json | Metadados completos do arquivo (do download). |
<listararquivosgoogledrive.content> | string | Conteúdo do arquivo como texto. |
<listararquivosgoogledrive.nextPageToken> | string | Token para buscar a próxima página de resultados. |
<listararquivosgoogledrive.permission> | json | Detalhes da permissão. |
<listararquivosgoogledrive.permissions> | json | Lista de permissões. |
<listararquivosgoogledrive.user> | json | Informações do usuário. |
<listararquivosgoogledrive.storageQuota> | json | Informações da cota de armazenamento. |
<listararquivosgoogledrive.canCreateDrives> | boolean | Indica se o usuário pode criar drives compartilhados. |
<listararquivosgoogledrive.importFormats> | json | Mapa dos tipos MIME que podem ser importados. |
<listararquivosgoogledrive.exportFormats> | json | Mapa dos tipos MIME do Google Workspace e dos formatos de exportação. |
<listararquivosgoogledrive.maxUploadSize> | string | Tamanho máximo de envio, em bytes. |
<listararquivosgoogledrive.deleted> | boolean | Indica se o arquivo ou comentário foi excluído. |
<listararquivosgoogledrive.removed> | boolean | Indica se a permissão foi removida. |
<listararquivosgoogledrive.exportedMimeType> | string | Tipo MIME para o qual o arquivo foi exportado. |
<listararquivosgoogledrive.revisions> | json | Lista de versões do arquivo. |
<listararquivosgoogledrive.revision> | json | Uma única versão do arquivo. |
<listararquivosgoogledrive.comments> | json | Lista de comentários do arquivo. |
<listararquivosgoogledrive.comment> | json | Um único comentário do arquivo. |
<listararquivosgoogledrive.commentId> | string | ID de um comentário excluído. |
Exemplo de uso
Objetivo: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.
- Operação
- Listar arquivos
- Conta do Google Drive
- (escolha a conta conectada)
- Conta representada
- cliente@exemplo.com
- Selecionar pasta
- (escolha na lista do campo)
- Consulta de busca
- SELECT * FROM clientes WHERE status = 'ativo'
- Resultados por página
- 10
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <listararquivosgoogledrive.file>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- Erro de autorização ou permissão (401/403)
- A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- Acrescentar dados · Google SheetsAcrescentar dados usando a conexão Google Sheets deste workspace.
- Adicionar pergunta de múltipla escolha · Google FormsGerencie formulários e respostas do Google Forms.
- Adicionar pergunta de texto · Google FormsGerencie formulários e respostas do Google Forms.
- Aplicar estilo de parágrafo · Google DocsAplicar estilo de parágrafo usando a conexão Google Docs deste workspace.
- Aplicar estilo de texto · Google DocsAplicar estilo de texto usando a conexão Google Docs deste workspace.
- Atualizar arquivo · Google DriveAtualizar arquivo usando a conexão Google Drive deste workspace.