GOOGLE DRIVE

Cometa consente a ciascun utente di collegare un Drive di Google.
Il vantaggio è quello di potere modificare e condividere documenti direttamente on-line.
In Cometa sarà memorizzato il collegamento al documento.
Se un utente ha attivato il proprio drive di google, tutti i documenti che aggiungerà da Cometa saranno aggiunti al suo drive e sarà automaticamente concesso l'accesso in lettura a chiunque abbia il link.
Dal proprio drive sarà poi possibile dare i permessi di scrittura a chi desiderato.
La cancellazione del documento da Cometa non comporterà l'eliminazione dal Drive di Google, ma sarà eliminato il solo riferimento da Cometa.

I file caricati da Cometa su Drive saranno memorizzati rispettando il percorso di cartelle e sottocartelle di Cometa che saranno replicate sul Drive di Google.
Cometa creerà un drive condiviso all'interno del proprio drive di Google con nome COMETA DRIVE - [nomeutente].
Al suo interno sarà creata in automatico la stessa struttura di cartelle presente in Cometa.
I file che sono caricati su Cometa sfogliando il Drive di Google invece manterranno la loro posizione originale su Drive e non saranno spostati.

CONFIGURAZIONE

Per collegare il proprio "Drive di Google" è necessario impostare 3 parametri:

1. ID Client
2. Client secret
3. Refresh token\

Questi parametri possono essere generati in autonomia utilizzando i servizi di Google.
La procedura non è delle più semplici ma neanche eccessivamente complessa.
Di seguito sarà spiegato passo passo come ottenere i 3 parametri sopra citati.

CONFIGURAZIONI PRELIMINARI

Anzitutto occorre aprire il browser e collegarsi all'account di google di cui si vuole utilizzare il drive.
Per fare questo cliccare qui https://www.google.it
Cliccare in alto a destra su Accedi se non si è già connessi a nessun account.
Viceversa se si è già connessi all'account desiderato non occorre fare nulla. Se si vuole cambiare account occorre di disconnettersi e connettersi con l'account desiderato.



Una volta connessi andare al seguente indirizzo https://console.cloud.google.com

CREAZIONE PROGETTO

Se non si è ancora creato un progetto in alto a sinistra cliccare su Crea progetto



In alternativa si può scegliere uno dei progetti che si sono già creati o crearne comunque uno nuovo.



Dare un nome al progetto Es: Cometa Drive e se non viene automaticamente selezionato selezionarlo.
A questo punto dal menù scegliere la voce



API e servizi in quanto dobbiamo andare ad abilitare il servizio "Google Drive"
Quindi cliccare su + ABILITA API E SERVIZI. Scorrere in basso e scegliere: Google Drive API

Quindi cliccare su "Abilita"



Si verrà rimandati alla sezione di gestione dei servizi API.
Cliccare su Credenziali



Successivamente su + CREA CREDENZIALI e scegliere ID client OAuth


Cliccare su CONFIGURA SCHERMATA DI CONSENSO e scegliere Esterno come User type



Poi cliccare su CREA

A questo punto occorre seguire una serie di passaggi.
Nel primo passaggio specificare solamente i campi obbligatori:

• Informazioni dell'applicazione
  • Nome applicazione
  • Email assistenza utenti
• Informazioni per lo sviluppatore
  • Indirizzo email
    

Successivamente cliccare sempre su SALVA E CONTINUA fino allo step 3 Utenti di prova
A questo punto aggiungere il proprio account come utente di prova. Questa configurazione è importante per la generazione del Refresh Token.
Si può fare anche successivamente ma meglio configurarla subito.



Cliccare su SALVA E CONTINUA e poi TORNA ALLA DASHBOARD

CREAZIONE ID CLIENT E CLIENT SECRET

Cliccare nuovamente su Credenziali e + CREA CREDENZIALI e nuovamente su ID Client OAuth
Scegliere come Tipo applicazione: Applicazione web e come nome ad es: Cometa.
IMPORTANTISSIMO!!! Qui sotto dobbiamo andare a configurare gli URI di reindirizzamento autorizzati e nel nostro caso dobbiamo aggiungere:

• https://developers.google.com/oauthplayground

Mi raccomando la stringa così com'è senza la barra finale.





Confermare cliccando su CREA

A questo punto appare la schermata



Da qui è possibile copiare: ID Client e Client secret. Si può anche scaricare il json che contiene tra gli altri anche questi dati.
E' comunque sempre possibile recuperare queste due chiavi cliccando sull'item appena creato.



Nella pagina risultante in alto a destra possiamo recuperare

• ID Client
• Client Secret

CREAZIONE REFRESH TOKEN

A questo punto manca solo la generazione del Refresh Token
Aprire il seguente link https://developers.google.com/oauthplayground
Cercare Drive API v3 e copiare e incollare https://www.googleapis.com/auth/drive in basso a fianco del bottone Authorize APIs.



Prima di cliccare sul bottone di autorizzazione, cliccare sull'icona ingranaggio per specificare i parametri di configurazione.



Spuntare il check Use your own OAuth credentials e specificare l'ID Client e il Client secret creati precedentemente



Quindi Cliccare su Close.
A questo punto possiamo cliccare su Authorize APIs
Viene richiesto l'account e noi scegliamo l'account che stiamo utilizzando



Successivamente sarà richiesto il consenso che dobbiamo accettare



Quindi si sarà rimandati alla pagina dove è possibile generare il Refresh token



Cliccare su Exchange authorization code for tokens



FATTO!!! Copiamo il Refresh token e passiamo a Cometa.

CONFIGURAZIONE COMETA

Dal menù di Cometa Documenti->Google Drive
Inseriamo i 3 parametri richiesti.



Sono a disposizione 3 bottoni:

• Configura: salva la configurazione corrente se corretta
• Test: effettua un test di connessione
• Annulla: rimuove la configurazione corrente