Connettore Google Drive

Connettore Google Drive

Integrazione di Tulip con l'API di Google Drive v3

Introduzione

L'API di Google Drive consente agli utenti di creare, leggere e modificare i file di Google Drive con il giusto accesso impostato sui loro account Google. L'obiettivo di questo connettore è utilizzare l'autenticazione Oauth2.0 e integrare l'API Google Drive V3 con Tulip utilizzando i connettori HTTP e fornire ai nostri clienti un connettore pronto all'uso che può essere importato nella loro istanza.

Scopo

1. Verranno evidenziate diverse funzioni di connettore HTTP che possono essere costruite effettuando chiamate HTTP agli endpoint dell'API di Google Drive V3 per interagire con Google Drive e provare varie azioni di lettura e scrittura sul disco che potrebbero essere sfruttate per vari casi d'uso.

Documento API

Documento API di Google Drive

Impostazione dell'API di Google

Come per molti connettori, la configurazione al di fuori di Tulip è la parte più difficile dell'integrazione. Date un'occhiata a questa video-guida che illustra il processo di creazione di un progetto API di Google, le credenziali e il loro inserimento nel plugin della libreria di Google Drive.

Prerequisiti

1. Creare un account sulla Console cloud di Google e configurare le credenziali OAuth 2.0. Ulteriori informazioni sono disponibili nei documenti API di Google.
2. Attivare l'API di Google Drive nella Console API di Google.

Dettagli della connessione Tulip

Le seguenti informazioni devono essere configurate sui connettori di Tulip.

1. In esecuzione su: Host del connettore cloud
2. Host:www.googleapis.com
3. Porta: 443
4. TLS: Sì
5. Scopi che devono essere configurati nel connettore:
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

Funzioni del connettore

Ottieni tutti i file dell'unità

Scopo

Questo connettore recupera tutti i file presenti nel drive di Google di un utente.

Punto finale

Chiamata HTTP GET all'endpoint https://www.googleapis.com:443/drive/v3/files?fields=*

Input richiesti

Nessun input richiesto

Estrattore di output richiesto

1. Id file: Identificatore univoco del file che verrà utilizzato per eseguire gli altri compiti.
2. Nome file: Il nome del file
3. I parametri aggiuntivi che vengono restituiti con la risposta possono essere inclusi come parte dei parametri di output.

Ottieni metadati specifici del file

Scopo

Questo connettore recupera i metadati di un file esistente nell'unità.

Punto finale

Chiamata HTTP GET all'endpoint - https://www.googleapis.com:443/drive/v3/files/{FileID}?fields=*

Input richiesti

I parametri URL da passare sono i seguenti

1. Id file

Estrattore di output richiesto

1. File Id: Identificatore univoco del file che verrà utilizzato per eseguire gli altri compiti.
2. Nome file: Il nome del file
3. I parametri aggiuntivi che vengono restituiti con la risposta possono essere inclusi come parte dei parametri di output

Crea nuovo file

Scopo

1. Gli utenti possono passare un nome di file con estensione e descrizione come input e Tulip creerà un nuovo file con il nome di file fornito. La risposta dell'API sarà costituita dai metadati e dalle varie proprietà del file.
2. Le informazioni estratte dall'API di Google Drive V3 possono essere utilizzate all'interno delle applicazioni Tulip, delle tabelle Tulip o delle variabili Tulip che vengono convogliate in altre funzioni del connettore. Queste informazioni possono essere utilizzate anche con altri connettori di Google.

Punto finale

Chiamata HTTP POST all'endpoint https://www.googleapis.com:443/drive/v3/files Input richiesto

Input richiesti

I parametri che vengono inviati come corpo della richiesta sono i seguenti

1. Nome del file - Il titolo del file con estensione
2. Descrizione - Descrizione del file

Estrattore di output richiesto

1. Id del file: Identificatore univoco del file che verrà utilizzato per eseguire le altre operazioni.
2. Nome file: Il nome del file
3. I parametri aggiuntivi che vengono restituiti con la risposta possono essere inclusi come parte dei parametri di output

Elimina file

Scopo

1. Gli utenti possono passare l'ID del file come input e Tulip cancellerà il file nell'unità.

Punto finale

Chiamata HTTP DELETE all'endpoint - https://www.googleapis.com:443/drive/v3/files

Input richiesti

I parametri che vengono inviati come corpo della richiesta sono i seguenti

1. ID file

Estrattore di output richiesto

Non viene estratto alcun output poiché la risposta è vuota.