- Impressão
::: (info) () Para fazer o download do aplicativo, visite: Biblioteca::::
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 à API do Google Drive V3 com a Tulip usando conectores HTTP e fornecer aos nossos clientes um conector pronto para uso que possa ser importado para sua instância.
Objetivo
- Vamos destacar diferentes funções do conector HTTP que podem ser criadas por meio de chamadas HTTP para os endpoints 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 doGoogle 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
- 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.
- 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.
- Em execução: host do conector de nuvem
- Host: www.googleapis.com
- Porta:443
- TLS: Sim
- Escopos que precisam ser configurados no conector:
- https://www.googleapis.com/auth/drive
- https://www.googleapis.com/auth/drive.file
- https://www.googleapis.com/auth/drive.metadata
- 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
- Id do arquivo: Identificador exclusivo do arquivo que será usado para executar as outras tarefas.
- File Name (Nome do arquivo): O nome do arquivo
- 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
- Id do arquivo
Extração de saída obrigatória
- Id do arquivo: Identificador exclusivo do arquivo que será usado para executar as outras tarefas.
- File Name (Nome do arquivo): O nome do arquivo
- 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
- 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.
- 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
- Nome do arquivo - O título do arquivo com extensão
- Description (Descrição) - Descrição do arquivo
Extrator de saída obrigatório
- Id do arquivo: Identificador exclusivo do arquivo que será usado para executar as outras tarefas
- File Name (Nome do arquivo): O nome do arquivo
- 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
- 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
- ID do arquivo
Extrator de saída obrigatório
Nenhuma saída é extraída, pois ela retorna uma resposta vazia.