Conector do Google Drive

Integração da Tulip com a API v3 do Google Drive

Introdução

A API do Google Drive permite que os usuários criem, leiam e editem arquivos do Google Drive com o acesso correto definido para suas contas do Google. O objetivo desse conector é usar a autenticação Oauth2.0 e integrar-se ao Google Drive V3 API com a Tulip usando conectores HTTP e fornecer aos nossos clientes um conector pronto para uso que pode ser importado para sua instância.

Objetivo

1. Vamos destacar diferentes funções do conector HTTP que podem ser criadas por meio de chamadas HTTP para os pontos de extremidade da API do Google Drive V3 para interagir com o Google Drive e experimentar várias ações de leitura e gravação na unidade que podem ser aproveitadas para vários casos de uso.

Documento da API

Documento da API do Google Drive

Configuração da API do Google

Como muitos conectores, a configuração fora do Tulip é a parte mais difícil da integração. Confira este guia em vídeo que explica o processo de criação de um projeto de API do Google, credenciais e como trazê-las para o plug-in de biblioteca do Google Drive.

Pré-requisitos

1. Crie uma conta no console de nuvem do Google e configure as credenciais OAuth 2.0. Mais informações podem ser encontradas nos documentos da API do Google.
2. Ativar a API do Google Drive no Console de API do Google.

Detalhes da conexão Tulip

As informações a seguir precisariam ser configuradas nos conectores da Tulip.

1. Em execução: host do conector de nuvem
2. Host: www.googleapis.com
3. Porta:443
4. TLS: Sim
5. Escopos que precisam ser configurados no conector:
6. https://www.googleapis.com/auth/drive
7. https://www.googleapis.com/auth/drive.file
8. https://www.googleapis.com/auth/drive.metadata
9. https://www.googleapis.com/auth/drive.appdata

Funções do conector

Obter todos os arquivos da unidade

Objetivo

Esse conector buscará todos os arquivos existentes no Google Drive de um usuário.

Ponto de extremidade

Chamada HTTP GET para o ponto de extremidade https://www.googleapis.com:443/drive/v3/files?fields=*

Entrada necessária

Não são necessárias entradas

Saída necessária Extractor

1. Id do arquivo: Identificador exclusivo do arquivo que será usado para executar as outras tarefas.
2. File Name (Nome do arquivo): O nome do arquivo
3. Parâmetros adicionais que são retornados com a resposta podem ser incluídos como parte dos parâmetros de saída

Obter metadados específicos do arquivo

Objetivo

Esse conector buscará os metadados de um arquivo existente na unidade.

Ponto de extremidade

Chamada HTTP GET para o ponto de extremidade - https://www.googleapis.com:443/drive/v3/files/{FileID}?fields=*

Entrada obrigatória

A seguir estão os parâmetros de URL que devem ser passados

1. Id do arquivo

Extração de saída obrigatória

1. Id do arquivo: Identificador exclusivo do arquivo que será usado para executar as outras tarefas.
2. File Name (Nome do arquivo): O nome do arquivo
3. Parâmetros adicionais que são retornados com a resposta podem ser incluídos como parte dos parâmetros de saída

Criar novo arquivo

Objetivo

1. Os usuários podem passar um nome de arquivo com extensão e descrição como entrada e a Tulip criará um novo arquivo com o nome de arquivo fornecido. A resposta da API será os metadados e várias propriedades do arquivo.
2. As informações extraídas da API do Google Drive V3 podem ser usadas em aplicativos Tulip, tabelas Tulip ou variáveis Tulip que seriam canalizadas para outras funções do conector. Essas informações também podem ser usadas com outros conectores do Google.

Ponto final

Chamada HTTP POST para o endpoint https://www.googleapis.com:443/drive/v3/files Entrada obrigatória

Entrada obrigatória

Os parâmetros a seguir são enviados como corpo da solicitação

1. Nome do arquivo - O título do arquivo com extensão
2. Description (Descrição) - Descrição do arquivo

Extrator de saída obrigatório

1. Id do arquivo: Identificador exclusivo do arquivo que será usado para executar as outras tarefas
2. File Name (Nome do arquivo): O nome do arquivo
3. Parâmetros adicionais que são retornados com a resposta podem ser incluídos como parte dos parâmetros de saída

Excluir arquivo

Objetivo

1. Os usuários podem passar o ID do arquivo como entrada e o Tulip excluirá o arquivo na unidade.

Ponto final

Chamada HTTP DELETE para o ponto de extremidade - https://www.googleapis.com:443/drive/v3/files

Entrada obrigatória

Os parâmetros a seguir são enviados como corpo da solicitação

1. ID do arquivo

Extrator de saída obrigatório

Nenhuma saída é extraída, pois ela retorna uma resposta vazia.