Introduzione
Collegare Google Drive per rendere i file dei Drive condivisi conoscenze ricercabili in Docebo.
Questo connettore sincronizza in Docebo Knowledge i file dei Drive condivisi a cui l'account collegato ha accesso. Riguarda solo il contenuto dei file di Drive, non le altre app di Google Workspace.
1. Informazioni di base
Quali contenuti vengono sincronizzati
| Tipo di contenuto | Stato | Nota |
|---|---|---|
| File nei Drive condivisi di cui l'account collegato è membro o a cui ha accesso | Sincronizzato | Google Docs, Sheets, Slides, PDF e altri tipi supportati |
| File in Il mio Drive (Drive personali) | Non sincronizzato | Fuori ambito, anche se condivisi singolarmente con l'account collegato — vedere la nota sotto |
| Gmail, Calendar, Google Sites e altre app di Workspace | Non sincronizzato | Fuori ambito per questo connettore |
| File nel cestino | Non sincronizzato | |
| Risposte di Google Forms | Non sincronizzato |
Quali contenuti vengono estratti
| Contenuto | Stato |
|---|---|
| Contenuto testuale di Docs, Sheets, Slides e PDF | Estratto |
| Titolo, proprietario, percorso della cartella, data dell'ultima modifica | Estratto |
| Immagini e grafici incorporati | Non estratto |
| Commenti e suggerimenti | Non estratto |
| Cronologia delle revisioni | Non estratto |
Questo connettore sincronizza solo i Drive condivisi — non legge l'area personale Il mio Drive dell'account collegato. I singoli file condivisi direttamente con tale account, anziché trovarsi in un Drive condiviso, sono fuori ambito. Per sincronizzarli, spostarli o aggiungerli a un Drive condiviso a cui l'account ha accesso.
2. Prerequisiti nel sistema di origine
Ruolo richiesto
L'account Google Workspace usato per autorizzare questo connettore deve disporre di diritti di amministratore per Utenti, Gruppi e Domini (in genere un amministratore di Workspace). Il connettore richiede ambiti Admin Directory di sola lettura oltre all'accesso a Drive, e tali chiamate API non riescono per un account non amministratore anche quando la schermata di consenso viene superata.
Impostazioni richieste
Sia la Google Drive API sia la Admin SDK API devono essere abilitate nel progetto Google Cloud — in caso contrario, gli ambiti Admin Directory non compaiono nel selettore degli ambiti.
L'account collegato deve essere membro di ogni Drive condiviso da sincronizzare o avervi accesso.
3. Preparare il sistema di origine
Abilitare la Drive API
Andare alla pagina della Google Drive API nel Google Cloud Marketplace e selezionare Abilita per il progetto.
Scheda della Google Drive API nel Google Cloud Marketplace.
Aprire Credenziali
Dalla pagina della Drive API, selezionare Gestione. Nella barra laterale sinistra della pagina che si apre, selezionare Credenziali.
Pagina dei dettagli del servizio Drive API, con Credenziali nella barra laterale sinistra.
Creare l'ID client OAuth
Nella pagina Credenziali, selezionare + Crea credenziali → ID client OAuth, scegliere Applicazione web e aggiungere l'URI di reindirizzamento in URI di reindirizzamento autorizzati. L'URI segue sempre questo schema: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback — ad esempio, https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
Client ID per applicazione web, con l'URI di reindirizzamento e la sezione dei client secret.
Salvare, quindi selezionare + Aggiungi secret per generare un client secret. Copiare sia il Client ID sia il Client secret — il secret viene mostrato una sola volta.
Pagina Credenziali, con Crea credenziali e l'elenco degli ID client OAuth 2.0.
Aggiungere gli ambiti richiesti
Nella barra laterale sinistra, selezionare Accesso ai dati, quindi selezionare Aggiungi o rimuovi ambiti. Incollare gli ambiti seguenti nella casella Aggiungi manualmente gli ambiti, selezionare Aggiungi alla tabella, quindi Salva.
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.activity.readonly
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/admin.directory.domain.readonly
https://www.googleapis.com/auth/admin.directory.group.readonly
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/userinfo.profile
| Scopo | Cosa consente |
|---|---|
| drive.readonly | Visualizzare e scaricare tutti i file di Google Drive |
| drive.activity.readonly | Visualizzare il registro delle attività dei file in Google Drive |
| admin.directory.user.readonly | Visualizzare le informazioni sugli utenti del dominio |
| admin.directory.domain.readonly | Visualizzare i domini relativi ai clienti |
| admin.directory.group.readonly | Visualizzare i gruppi del dominio |
| userinfo.email | Visualizzare l'indirizzo email principale dell'account Google |
| userinfo.profile | Visualizzare le informazioni personali, incluse quelle rese pubblicamente disponibili |
Gli ambiti Admin Directory indicati sopra compaiono qui solo dopo aver abilitato la Admin SDK API in questo progetto, oltre alla Drive API.
Accesso ai dati — Aggiorna gli ambiti selezionati, con gli ambiti aggiunti manualmente.
4. Azioni richieste in Docebo
| Informazioni da inserire | Dove trovarle |
|---|---|
| Client ID | Console Google Cloud → API e servizi → Credenziali → il proprio client OAuth |
| Client secret | Console Google Cloud → API e servizi → Credenziali → il proprio client OAuth (copiarlo al momento della creazione — non verrà mostrato di nuovo) |
| ID del Drive condiviso | Aprire il Drive condiviso in Drive: l'ID è la parte dell'URL dopo /folders/ |
Autorizzare il connettore
- Andare in Componenti aggiuntivi e integrazioni → Connettori di conoscenze → Crea → Google Drive. Questo menu è visibile solo ai Superadmin.
- Inserire il Client ID e il Client secret.
Collega Google Drive — scheda Autenticazione con i campi Client ID e Client secret.
- Selezionare Autorizza con Google e accedere con un account che abbia accesso ai contenuti da sincronizzare.
- Scegliere i Drive condivisi da sincronizzare, quindi selezionare Salva.
Collega Google Drive — scheda Scopo per selezionare i drive da sincronizzare.