Consulte os conectores compatíveis com a Application Integration.

Google Drive: listar tarefa

Visualização

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

A tarefa Drive: Lista permite pesquisar e recuperar arquivos e pastas armazenados em uma conta do Google Drive.

O Google Drive é um serviço de armazenamento de arquivos na nuvem que oferece espaço de armazenamento pessoal para você armazenar e acessar pastas e arquivos compartilhados colaborativos na nuvem.

Antes de começar

Realize as seguintes tarefas no seu projeto do Google Cloud antes de configurar a tarefa Drive - List:

1. Ative a API Google Drive (drive.googleapis.com).

   Ativar a API Google Drive

2. Criar um perfil de autenticação. A Application Integration usa um perfil de autenticação para se conectar a um endpoint de autenticação para a tarefa Drive - Lista.

   Para informações sobre como conceder papéis ou permissões adicionais a uma conta de serviço, consulte Como conceder, alterar e revogar acesso.

Configure a tarefa "Drive - List"

1. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrações.

   A página Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração existente ou clique em Criar integração para criar uma nova.

   Se você estiver criando uma integração:

   1. Digite um nome e uma descrição no painel Create Integration.
   2. Selecione uma região para a integração.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   3. Selecione uma conta de serviço para a integração. Você pode mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas.
      Observação:a opção de selecionar uma conta de serviço só vai aparecer se você tiver ativado a governança de integração na região selecionada.
   4. Clique em Criar.

   Isso abre a integração na página do editor de integração.

4. Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas disponíveis.
5. Clique e coloque o elemento Drive - Lista no editor de integração.
6. Clique no elemento Drive – Lista no Designer para ver o painel de configuração de tarefas Drive – Lista.
7. Acesse Autenticação e selecione o perfil de autenticação que você quer usar.

   Opcional. Se você não tiver criado um perfil de autenticação antes de configurar a tarefa, clique em + Novo perfil de autenticação e siga as etapas em Criar um novo perfil de autenticação.

8. Acesse Entrada de tarefas e configure os campos de entrada exibidos com a tabela Parâmetros de entrada de tarefas.

   As mudanças nos campos de entrada são salvas automaticamente.

Parâmetros de entrada da tarefa

A tabela a seguir descreve os parâmetros de entrada da tarefa Drive - List:

Propriedade	Tipo de dados	Descrição
Corpora	String	Parâmetro opcional para pesquisar arquivos em um corpora.
DriveId	String	O código do seu drive compartilhado do Google.
IncludeItemsFromAllDrives	Booleano	Defina o valor como true se você quiser incluir seu drive pessoal e itens do drive compartilhado nos resultados da pesquisa. Valor padrão: false.
IncludeLabels	String	Uma lista separada por vírgulas de IDs de rótulos que está incluída na parte labelInfo da resposta. Para mais informações sobre IDs de rótulos, consulte Visão geral de rótulos.
IncludePermissionsForView	String	Especifique published. Veja mais informações em Compartilhar arquivos, pastas e drives.
OrderBy	String	A ordem em que os arquivos são classificados. Os valores aceitáveis são os seguintes: createdTime folder modifiedByMeTime modifiedTime name name_natural quotaBytesUsed recency sharedWithMeTime starred viewedByMeTime
PageSize	Inteiro	O número máximo de arquivos a serem retornados por página. Os valores aceitáveis são de 1 a 1000. Valor padrão: 100.
PageToken	String	O token para continuar uma tarefa anterior do Drive - List. Defina esse valor como nextPageToken da resposta anterior.
Q	String	Uma consulta para filtrar os resultados do arquivo. Para mais informações, consulte Pesquisar arquivos.
Spaces	String	Uma lista separada por vírgulas de espaços para consulta em corpora. Os valores aceitáveis são drive e appDataFolder.
SupportsAllDrives	Booleano	Defina o valor como true se o aplicativo solicitante for compatível com Meu Drive e com os drives compartilhados. Valor padrão: false.

Saída da tarefa

A tarefa Drive: List retorna o resultado da resposta que contém a lista de arquivos. Veja a seguir um exemplo de saída:

  {
    "nextPageToken": string,
    "kind": string,
    "incompleteSearch": boolean,
    "files": [
      {
        object (File)
      }
    ]
  }

Estratégia de solução de erros

A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.

A seguir

1. Adicione bordas e condições de borda.
2. Teste e publique sua integração.
3. Configure um gatilho.
4. Adicione uma tarefa de mapeamento de dados.
5. Confira todas as tarefas para os serviços do Google Cloud.