Introduzione

L’integrazione di Docebo con Google Drive permette di caricare documenti Google, fogli di calcolo, slide e disegni come materiali didattici in piattaforma, rendendoli disponibili agli studenti sia sulla versione desktop che sulla versione mobile della piattaforma. 

Chi ha attivato Discover, Coach & Share può inoltre usufruire dell’integrazione con Google Drive per caricare i contributi attraverso la funzionalità dedicata. 

L’integrazione fra Docebo e Google Drive può includere Google Picker, una finestra di dialogo File Open dove gli utenti possono caricare i file presenti nel proprio Drive di Google in Docebo. Questo articolo descrive come utilizzare l’integrazione con e senza Google Picker. Per ulteriori informazioni su Google Picker, consultare la documentazione Google Picker API su Google (si apre in una nuova scheda).

Requisiti e limitazioni

• Non è possibile creare materiale didattico Google Drive direttamente nei corsi, ma è possibile crearlo nell'archivio centrale e poi aggiungerlo ai corsi.

Attivare Google Drive in Docebo

Attivare la app Google Drive come descritto nell'articolo della Knowledge Base dedicato alla gestione di applicazioni e funzionalità. La app si trova nella scheda Integrazione Software Terzi.

Creare un progetto Google per l’integrazione con Docebo

Il primo passo per configurare l'integrazione fra Docebo e Google Drive è la creazione di un Google Project che utilizzi un Google Drive Scope specifico.

Connettersi al proprio account Google dalla Google Developer Console (si apre in una nuova scheda). Nella barra delle azioni della parte superiore della pagina, cliccare Create Project.

Definire il nome del progetto e, se necessario, modificare l'organization e la location in base alle proprie esigenze. Premere Create per procedere.

Al termine della creazione del progetto, premere l'icona notifica in alto a destra e selezionare il progetto nel menu a tendina.

Ora è necessario abilitare le API necessarie al progetto. Cliccare Enable APIs and Services nella parte superiore della pagina. 

Si accederà alla pagina API Library. Utilizzare la finestra di ricerca per cercare la stringa Google Picker API. Nell'elenco dei risultati, cliccare Google Picker API.

Si accederà alla pagina Google Picker API di Google. Cliccare Enable per attivare l'API.

Successivamente, è necessario abilitare l'API di Google Drive. Accedere alla scheda Library nel menu APIs & Services.

Si accederà alla pagina API Library. Utilizzare la finestra di ricerca per cercare la stringa Google Drive API. Nell'elenco dei risultati, cliccare Google Drive API.

Nella pagina dei risultati della ricerca, cliccare Google Drive API.

Si accederà alla pagina Google Drive API ; cliccare Enable per attivare l'API.

Sarà visualizzata la pagina di riepilogo dell'API di Google Drive. Cliccare Create Credentials per procedere.

Nella schermata seguente, selezionare Google Drive API nel primo menu a tendina e scegliere User data come tipo di dati a cui accedere. Cliccare Next per passare alla fase successiva.

Nella sezione che segue, assegnare alla propria App un nome significativo nell'area App name. Quindi, selezionare l'indirizzo e-mail appropriato dal menu a tendina nell'area User support email.

Scorrere verso il basso. Nella sezione Developer contact information aggiungere un indirizzo e-mail. Questo indirizzo e-mail può essere lo stesso selezionato nel menu a tendina. Premere Save and Continue per proseguire.

La sezione successiva consente di aggiungere gli scope necessari. Per farlo, premere Add or Remove Scopes.

Selezionare ora sia Google Drive API (.../auth/drive) che Google Drive API (.../auth/drive). Premere Update per tornare alla schermata principale.

Tornare alla schermata Create credentials e premere Save and Continue per passare alla sezione OAuth Client ID.

Nella sezione seguente scegliere Web application dal menu a tendina Application Type. Questa azione abiliterà la casella di testo Name. Assegnare all'ID client un nome significativo e spostarsi alla sezione Authorized JavaScript origins. Premere + Add URI per visualizzare la casella di testo URIs 1* e inserire l'URL della piattaforma nel formato di https://yourplatformname.docebosaas.com (sostituendo yourplatformname con il nome della propria piattaforma) senza slash in fondo all'URL.

Scorrere verso il basso e premere Create.

La sezione successiva mostra le proprie credenziali. Copiare e incollare queste informazioni in un editor di testo (come Notepad su Windows, ad esempio), serviranno in un secondo momento, quando si aggiungeranno le informazioni necessarie in Docebo. Cliccare Done per terminare la configurazione delle credenziali OAuth2.

Tornando alla schermata Google Drive API , accedere alla scheda Credentials nel menu laterale APIs & Services per accedere all'elenco delle credenziali.

La schermata successiva mostra l'elenco delle credenziali configurate. Cliccare + Create Credentials e selezionare API key dall'elenco.

Your API key will now be created and displayed on the screen. Copy and paste this API key into a text editor for later use in the Docebo platform. Then, press the Edit API key link in the modal window, do not press Close.

L'API key sarà creata e visualizzata. Copiare e incollare l'API key in un editor di testo per utilizzarla successivamente in Docebo. Premere il link Edit API key nella finestra pop-up, senza premere Close.

Nella schermata che si aprirà, Key restrictions, scorrere fino alla sezione API restrictions e selezionare Restrict key. Quindi cliccare sul menu a tendina Select APIs.

Nella finestra pop-up, selezionare sia Google Drive API che Google Drive API, quindi premere OK per confermare le scelte.

Quindi, premere Save per terminare la configurazione delle restrizioni API.

La configurazione in Google è terminata. Passare alla configurazione dell'integrazione di Google Drive in Docebo Learn.

Configurare Google Drive in Docebo

Per configurare Google Drive in Docebo, accedere al Menu Amministrazione, dall'icona ingranaggio in alto a desta.

Identificare la sezione Google Drive e premere Gestione.

 

Si accederà alla pagina delle Impostazioni di Google Drive. Nella parte superiore della pagina, selezionare l’opzione Abilita Google Drive, inserire la API Key e il Client ID nei campi di testo corrispondenti. 

Premere Salva le Modifiche per completare la configurazione. 

In qualsiasi momento è possibile eseguire il reset della configurazione di Google Drive cliccando Reset della Configurazione. Quando si esegue il reset, la Chiave API e il Client ID sono cancellati e non sarà più possibile utilizzare l'integrazione finché non si inseriranno nuovamente dei valori validi.

Caricare materiali didattici con Google Picker

È possibile caricare Documenti Google, fogli di calcolo, slide o disegni (in formato nativo) direttamente in un corso o nell'archivio centrale. Anche se si carica in un corso, sarà possibile inserire gli oggetti nell'archivio centrale in un secondo momento. Vediamo come caricare un materiale didattico da Google Drive direttamente in un corso. 

Per caricare contenuti Google Drive per un corso, connettersi alla piattaforma come Superadmin e accedere al Menu Amministrazione dall'icona ingranaggio in alto a destra. Selezionare Gestione Corsi dalla sezione E-Learning. Identificare il corso per cui si desidera caricare dei contenuti Google Drive e cliccare sulla descrizione, quindi spostarsi alla scheda Materiali Didattici. Da qui cliccare Aggiungi Materiali Didattici e selezionare Google Drive dal menu a tendina.

Attenzione! I contenuti Google Drive possono essere caricati come materiale didattico solo all’interno di corsi e-learning.

Nella pagina di caricamento del materiale didattico Google Drive, contrassegnare l'opzione Importa file nella riga Fonte del File di Google nella parte superiore della pagina. Quindi, selezionare Carica da Google Drive. Sarà visualizzato Google Picker. In Google Picker, è possibile utilizzare le schede in alto nella pagina per visualizzare documenti, presentazioni, fogli di calcolo o disegni. Una volta trovato l’oggetto che si desidera importare, selezionarlo e premere Seleziona in basso a sinistra.

Il titolo assegnato al materiale didattico in piattaforma corrisponderà al titolo dell'oggetto in Google Drive, ma sarà possibile modificarlo. Definire una descrizione per il materiale didattico nella casella di testo corrispondente, quindi passare alla scheda Informazioni Aggiuntive per aggiungere una breve descrizione e selezionare una thumbnail.

È possibile inserire dei tag relativi al materiale didattico, in modo che sia più semplice trovarlo attraverso la ricerca globale della piattaforma. Se la funzionalità di auto-tagging è abilitata in piattaforma, è possibile che alcuni tag siano generati automaticamente dell'intelligenza artificiale in base al contenuto del materiale didattico, e solo nel caso in cui il contenuto sia in inglese, spagnolo, tedesco, francese, italiano o portoghese. I tag possono essere modificati o cancellati in qualsiasi momento, con un limite di 15 tag per materiale didattico e di 32 caratteri per ogni tag.

I tipi di file accettati per l'auto-tagging in piattaforma sono:

Tipo di contenuto	Valore
File di testo	TXT, CSV, JSON, RTF
Documenti	DOC, DOCX, ODT, PPT, PPTX, PDF, XLSX, XLS
Immagini	GIF, JPG, JPEG, PNG, TIFF, TIF
File Web	HTML, HTM
Video	MP4, MOV
Documenti Google	Docs, Sheets, Slides
Piattaforme video	YouTube, Vimeo, Wistia
File SCORM, AICC, e xAPI	Testo da pagine HTML Transcript di audio e video (video flash, SWF, MP4, MOV, WAV, MP3, MKV, OGG, FLAC) Testo da documenti e immagini (CSV, DOC, DOCX, JPEG, ODT, PDF, PPTX, PPT, RTF, TIFF, TXT, XLSX, XLS) Metadati dei corsi interni AICC (titolo, descrizione)

Per questioni di sicurezza, l'intelligenza artificiale della piattaforma non accede ai contenuti privati (quelli che richiedono un'autenticazione per accedervi), e può generare tag automaticamente solo per i contenuti pubblici. Quando si caricano contenuti privati, consigliamo di aggiungere i tag manualmente.

Al termine, selezionare Salva modifiche. 

Una volta caricato il file, sarà visualizzato nell'elenco dei materiali didattici del corso, nella pagina Materiali Didattici. Da qui, è possibile configurare il materiale didattico o inserirlo nell'archivio centrale selezionando l'icona del menu nella riga dell'oggetto e quindi un'opzione dal menu a tendina.

Caricare materiali didattici senza Google Picker

Per caricare un oggetto di Google Drive in piattaforma come materiale didattico, seguire le istruzioni descritte nella sezione precedente. Dopo aver selezionato l'opzione per caricare un oggetto di Google Drive in un corso, ed essere stato reindirizzato alla pagina di upload principale per l'oggetto, selezionare l'opzione URL Incorporata nella sezione Fonte del File di Google nella parte superiore della pagina.

Copiare e incollare il link di Google Drive per l'oggetto nella casella di testo messa a disposizione. Per ottenere questo link, aprire l'oggetto in Google Drive. Una volta nella pagina dell'oggetto, selezionare l'opzione File, e quindi Pubblica sul Web dal menu a tendina.

Nella casella pop up, deselezionare l'opzione che obbliga ad effettuare l'accesso prima di visualizzare il documento (se non si visualizza questa opzione, selezionare Contenuti Pubblicati e Impostazioni). Selezionare Pubblica e copiare il link che apparirà nella casella di testo. Incollare questo link nella casella di testo corrispondente nella pagina di caricamento della propria piattaforma Docebo.

Una volta incollato il link in piattaforma, apparirà un checkmark verde sul lato destro della pagina se la piattaforma Docebo riconosce come valido il link di Google Drive. In caso contrario, sarà visualizzata una X rossa: in tal caso, riprovare copiando e incollando nuovamente il link.

Aggiungere un titolo e una descrizione all’oggetto didattico nelle caselle di testo corrispondenti, e passare alla scheda Informazioni Aggiuntive per aggiungere una breve descrizione e selezionare una thumbnail. È possibile inserire dei tag relativi al materiale didattico, in modo che sia più semplice trovarlo attraverso la ricerca globale della piattaforma. Se la funzionalità di auto-tagging è abilitata in piattaforma, è possibile che alcuni tag siano generati automaticamente dell'intelligenza artificiale in base al contenuto del materiale didattico, e solo nel caso in cui il contenuto sia in inglese, spagnolo, tedesco, francese, italiano o portoghese. I tag possono essere modificati o cancellati in qualsiasi momento, con un limite di 15 tag per materiale didattico.

Per questioni di sicurezza, l'intelligenza artificiale della piattaforma non accede ai contenuti privati (quelli che richiedono un'autenticazione per accedervi), e può generare tag automaticamente solo per i contenuti pubblici. Quando si caricano contenuti privati, consigliamo di aggiungere i tag manualmente.

I tipi di file accettati per l'auto-tagging in piattaforma sono:

Tipo di contenuto	Valore
File di testo	TXT, CSV, JSON, RTF
Documenti	DOC, DOCX, ODT, PPT, PPTX, PDF, XLSX, XLS
Immagini	GIF, JPG, JPEG, PNG, TIFF, TIF
File Web	HTML, HTM
Video	MP4, MOV
Documenti Google	Docs, Sheets, Slides
Piattaforme video	YouTube, Vimeo, Wistia
File SCORM, AICC, e xAPI	Testo da pagine HTML Transcript di audio e video (video flash, SWF, MP4, MOV, WAV, MP3, MKV, OGG, FLAC) Testo da documenti e immagini (CSV, DOC, DOCX, JPEG, ODT, PDF, PPTX, PPT, RTF, TIFF, TXT, XLSX, XLS) Metadati dei corsi interni AICC (titolo, descrizione)

Al termine, selezionare Salva modifiche.

Una volta caricato il file, sarà visualizzato nell'elenco dei materiali didattici del corso, nella pagina Materiali Didattici. Da qui, è possibile gestire le impostazioni di un materiale didattico o inserirlo nell'archivio centrale selezionando l'icona del menu nella riga dell'oggetto e selezionando un'opzione dal menu a tendina.

Preparare e gestire i propri file in Google Drive

Prima di caricare un file da Goole Drive a Docebo, assicurarsi che la Condivisione sia definita come Chiunque abbia un link può visualizzare. Per configurare questa opzione, premere il pulsante File in Google Drive, quindi premere Condividi dal menu a tendina. Nella finestra pop-up, selezionare Ottieni Link Condivisibile. Aprire il menu a tendina, quindi premere Più. Selezionare l’opzione Chiunque abbia il link può visualizzare. Poi, selezionare Fine.

Quando si modifica il contenuto di un oggetto di Google Drive utilizzato come materiale didattico in Docebo, le modifiche sono applicate in piattaforma quasi in tempo reale; la sincronizzazione fra Google Drive e Docebo avviene ogni cinque minuti.  Se si cancella un oggetto in Google Drive utilizzato come materiale didattico in Docebo, non cancellare il materiale didattico dalla piattaforma, perché non sarà più possibile recuperarlo. 

Gestire i file di Google Drive in Docebo

Dopo aver caricato il file in Docebo da Google Drive, il file può essere visualizzato in qualsiasi modalità: modalità teatro, schermo intero, inline o in una nuova finesta. I link e i video inclusi nei file sono cliccabili e visualizzabili in Docebo. 

Quando uno studente apre il materiale didattico in Docebo, il materiale didattico di Google Drive è automaticamente identificato come completo al momento dell’apertura, indipendentemente dal tempo di visualizzazione del materiale. 

Suggerimenti

• Se si desidera disattivare Google Drive in Docebo dopo aver inserito degli oggetti di Google Drive come materiali didattici nei corsi, è necessario eliminare tutti i materiali didattici nella propria piattaforma Docebo prima di disattivare la app. 
• L'integrazione con Google Drive consente solo ai documenti che fanno parte di un Drive non condiviso di essere importati. I documenti salvati in un Drive condiviso invece non possono essere importati.