Drive – Listar tarefa

A tarefa Drive - List permite-lhe pesquisar e obter ficheiros e pastas armazenados numa conta do Google Drive.

O Google Drive é um serviço de armazenamento de ficheiros na nuvem que lhe oferece espaço de armazenamento pessoal para armazenar e aceder a ficheiros e pastas partilhados colaborativamente na nuvem.

Antes de começar

Certifique-se de que realiza as seguintes tarefas no seu projeto do Google Cloud antes de configurar a tarefa Drive - List:

Ative a API Google Drive (drive.googleapis.com).
Ative a API Google Drive
Crie um perfil de autenticação. A solução Application Integration usa um perfil de autenticação para se ligar a um ponto final de autenticação para a tarefa Drive - List.
Para informações sobre como conceder funções ou autorizações adicionais a uma conta de serviço, consulte o artigo Conceder, alterar e revogar o acesso.

Configure a tarefa Drive - Lista

Na Google Cloud consola, aceda à página Application Integration.
Aceda à solução Application Integration
No menu de navegação, clique em Integrações.
A página Integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.
Selecione uma integração existente ou clique em Criar integração para criar uma nova.
Se estiver a criar uma nova integração:
1. Introduza um nome e uma descrição no painel Criar integração.
2. Selecione uma região para a integração.
  Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
  Nota: a opção para selecionar uma conta de serviço é apresentada apenas se tiver ativado a gestão da integração para a região selecionada.
4. Clique em Criar. A integração recém-criada é aberta no editor de integração.
Na barra de navegação do editor de integração, clique em Tasks para ver a lista de tarefas e conetores disponíveis.
Clique e coloque o elemento Drive – Lista no editor de integração.
Clique no elemento Drive – Lista no criador para ver o painel de configuração da tarefa Drive – Lista.
Aceda a Autenticação e selecione um perfil de autenticação existente que quer usar.
Opcional. Se não tiver criado um perfil de autenticação antes de configurar a tarefa, clique em + Novo perfil de autenticação e siga os passos mencionados em Crie um novo perfil de autenticação.
Aceda a Entrada de tarefas e configure os campos de entrada pretendidos através da seguinte tabela de parâmetros de entrada de tarefas.
As alterações aos campos de entrada são guardadas automaticamente.

Parâmetros de entrada da tarefa

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

Propriedade	Tipo de dados	Descrição
`Corpora`	String	Parâmetro opcional para pesquisar ficheiros num corpora.
`DriveId`	String	O ID do seu disco partilhado do Google.
`IncludeItemsFromAllDrives`	Booleano	Defina o valor como `true` se quiser incluir os itens do seu disco pessoal e do disco partilhado nos resultados da pesquisa. Valor predefinido: `false`.
`IncludeLabels`	String	Uma lista de IDs de etiquetas separados por vírgulas que está incluída na parte `labelInfo` da resposta. Para mais informações sobre os IDs das etiquetas, consulte o artigo Vista geral das etiquetas.
`IncludePermissionsForView`	String	Especifique `published`. Para mais informações, consulte o artigo Partilhe ficheiros, pastas e discos.
`OrderBy`	String	A ordem pela qual os ficheiros são ordenados. Por predefinição, cada chave é ordenada por ordem ascendente. Para mais informações, consulte o método `files.list`. Seguem-se os valores válidos: `createdTime` `folder` `modifiedByMeTime` `modifiedTime` `name` `name_natural` `quotaBytesUsed` `recency` `sharedWithMeTime` `starred` `viewedByMeTime` Nota: quando ordena os ficheiros por `recency` ordem descendente, se a última ação que realizou foi ver um ficheiro, esse ficheiro aparece na parte superior do resultado `files.list`.
`PageSize`	Número inteiro	O número máximo de ficheiros a devolver por página. Os valores aceitáveis são de `1` a `1000`. Valor predefinido: `100`.
`PageToken`	String	O token para continuar uma tarefa Drive - List anterior. Defina este valor para o valor de `nextPageToken` da resposta anterior.
`Q`	String	Uma consulta para filtrar os resultados dos ficheiros. Para mais informações, consulte o artigo Pesquise ficheiros.
`Spaces`	String	Uma lista de espaços separada por vírgulas para consultar nos corpus. Os valores aceitáveis são `drive` e `appDataFolder`.
`SupportsAllDrives`	Booleano	Defina o valor como `true` se a aplicação que está a fazer o pedido suportar tanto O meu disco como os discos partilhados. Valor predefinido: `false`.

Resultado da tarefa

A tarefa Drive - List devolve o resultado da resposta com a lista de ficheiros. Segue-se um exemplo de resultado:

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

Estratégia de processamento de erros

Uma estratégia de processamento de erros para uma tarefa especifica a ação a realizar se a tarefa falhar devido a um erro temporário. Para obter informações sobre como usar uma estratégia de processamento de erros e conhecer os diferentes tipos de estratégias de processamento de erros, consulte o artigo Estratégias de processamento de erros.

Quotas e limites

Para informações sobre quotas e limites, consulte o artigo Quotas e limites.

O que se segue?

Adicione limites e condições de limite.
Teste e publique a sua integração.
Configure um acionador.
Adicione uma tarefa de mapeamento de dados.
Veja todas as tarefas para os serviços Google Cloud.