- Stampa
::: (info) () Per scaricare l'applicazione, visitare: Biblioteca:::
Integrazione di Tulip con Google Drive v3 API
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 possa essere importato nella loro istanza.
Scopo
- 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
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
- Creare un account sulla Console cloud di Google e configurare le credenziali OAuth 2.0. Ulteriori informazioni sono disponibili nei documenti API di Google.
- 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.
- In esecuzione su: Host del connettore cloud
- Host:www.googleapis.com
- Porta: 443
- TLS: Sì
- Scopi che devono essere configurati nel connettore:
- 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
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
- Id file: Identificatore univoco del file che verrà utilizzato per eseguire gli altri compiti.
- Nome file: Il nome del file
- 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
- Id file
Estrattore di output richiesto
- File Id: Identificatore univoco del file che verrà utilizzato per eseguire gli altri compiti.
- Nome file: Il nome del file
- I parametri aggiuntivi che vengono restituiti con la risposta possono essere inclusi come parte dei parametri di output
Crea nuovo file
Scopo
- 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.
- 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
- Nome del file - Il titolo del file con estensione
- Descrizione - Descrizione del file
Estrattore di output richiesto
- Id del file: Identificatore univoco del file che verrà utilizzato per eseguire le altre operazioni.
- Nome file: Il nome del file
- I parametri aggiuntivi che vengono restituiti con la risposta possono essere inclusi come parte dei parametri di output
Elimina file
Scopo
- 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
- ID file
Estrattore di output richiesto
Non viene estratto alcun output poiché la risposta è vuota.