Collega Google Drive (configurazione dell'account di servizio)

Google Drive Portal si collega a Google Drive con un account di servizio: un'identità Google tecnica che crei gratis nel tuo progetto Google Cloud. Scarichi la sua chiave (un piccolo file JSON), la dai al plugin e condividi una cartella di Drive con l'indirizzo dell'account di servizio. Tutta la guida richiede circa 10 minuti.

Non serve nessuna app OAuth. Questo plugin non usa "Accedi con Google". Non crei credenziali OAuth, non copi nessun redirect URI, non configuri una schermata di consenso, non aggiungi utenti di test e non pubblichi nessuna app. I tutorial che parlano di questi passaggi riguardano altri plugin. Il collegamento con l'account di servizio non scade dopo 7 giorni e non richiede nessuna verifica da parte di Google.

Prima di iniziare

Un account Google che può aprire la cartella di Drive che vuoi mostrare (un normale account Gmail o un account Google Workspace).
Il plugin installato e attivato (vedi Installa la versione gratuita).
In WordPress apri Documenti Drive > Portale. Tieni aperta questa pagina in una scheda del browser: la scheda Inizia da qui mostra a che punto sei, e il riquadro Collega Google Drive ha i link diretti alle pagine Google usate qui sotto.

Passo A: crea un progetto Google Cloud

Un progetto è un contenitore di Google Cloud che conserva le tue impostazioni. È gratuito: questo plugin usa l'API di Google Drive, che per un uso normale non costa nulla.

Vai su console.cloud.google.com/projectcreate e accedi con il tuo account Google. Se è la prima visita, accetta i termini di servizio.
In Project name (Nome progetto) scrivi un nome che riconoscerai, per esempio Documenti sito.
Lascia gli altri campi come sono e clicca Create (Crea).
Aspetta qualche secondo, poi controlla che il nuovo progetto sia selezionato nel selettore dei progetti in cima alla console.

Puoi anche usare un progetto che hai già.

Passo B: attiva l'API di Google Drive

Apri la pagina della Google Drive API (oppure, nel menu della console, APIs and services > Library (API e servizi > Libreria) e cerca Google Drive API).
Controlla che in alto sia selezionato il tuo progetto.
Clicca Enable (Abilita).

Se salti questo passaggio, più avanti il plugin ti dice: L'API di Google Drive non è attiva su questo progetto.

Passo C: crea l'account di servizio

Apri IAM e amministrazione > Account di servizio.
Clicca Create service account (Crea account di servizio).
Dagli un nome qualsiasi, per esempio wordpress-portal. Google compila un ID al posto tuo.
Clicca Create and continue (Crea e continua).
Le schermate successive chiedono ruoli e accesso degli utenti. Non concedere nulla: clicca solo Continue (Continua) e poi Done (Fine). L'account di servizio non ha bisogno di nessun ruolo Cloud.

Passo D: scarica la chiave JSON

Nell'elenco degli account di servizio clicca quello che hai appena creato.
Apri la scheda Keys (Chiavi).
Clicca Add key > Create new key (Aggiungi chiave > Crea nuova chiave).
Scegli JSON e clicca Create (Crea).
Sul tuo computer viene scaricato un file .json.

Conserva questo file al sicuro. È la password di questo collegamento. Non mandarlo via email e non metterlo in una cartella pubblica. Se lo perdi, crea semplicemente una nuova chiave nello stesso modo.

"Service account key creation is disabled"? Alcune organizzazioni Google Workspace bloccano la creazione di chiavi con un criterio dell'organizzazione. Chiedi all'amministratore di Google Workspace di consentire la creazione di chiavi per questo progetto, oppure crea il progetto con un account Google personale.

Passo E: dai la chiave al plugin

Torna in WordPress, Documenti Drive > Portale, riquadro Collega Google Drive.
Sotto Scegli il file JSON, scegli il file scaricato. Oppure, sotto Oppure incollane il contenuto, incolla tutto il contenuto del file (aprilo con un qualsiasi editor di testo e copia tutto, dalla prima { all'ultima }).
Clicca Salva la chiave.

Il plugin verifica subito la chiave con Google. Se funziona vedi: Chiave salvata e accettata da Google. Ora condividi la cartella di Drive con ... , come Visualizzatore. A quel punto il riquadro mostra Collegato a Google Drive con l'indirizzo dell'account di servizio, che ha questo aspetto: name@project-id.iam.gserviceaccount.com.

L'account di servizio non vede nulla nel tuo Drive finché non condividi una cartella con lui. È la condivisione a decidere cosa può mostrare il portale.

Nella pagina del plugin, nel riquadro Condividi una cartella Drive, clicca Copia accanto all'indirizzo dell'account di servizio.
Apri Google Drive e trova la cartella che vuoi mostrare sul sito.
Fai clic destro sulla cartella e scegli Share (Condividi; in alcune schermate Share > Share).
Incolla l'indirizzo dell'account di servizio nel campo Add people (Aggiungi persone).
Imposta il ruolo su Viewer (Visualizzatore). Visualizzatore basta: il plugin non scrive mai su Drive.
Clicca Send (Invia, oppure Share). Se Google avvisa che l'indirizzo è esterno alla tua organizzazione, è normale: conferma.
Torna in WordPress e ricarica la pagina Documenti Drive > Portale. La cartella compare nell'elenco Cartelle che l'account di servizio vede.

Tutto quello che c'è nella cartella condivisa è visibile al plugin, comprese le sottocartelle e i file che aggiungi in seguito. Nient'altro del tuo Drive lo è.

Condividi la cartella, non un file. Condividere singoli file non li fa comparire. Su un Drive condiviso puoi aggiungere l'indirizzo dell'account di servizio come membro del Drive condiviso (il Drive compare allora in Sfoglia, contrassegnato come Drive condiviso), oppure condividere con quell'indirizzo una cartella all'interno del Drive.

Passo G: esegui la verifica del collegamento

Nel riquadro Collega Google Drive, sotto Verifica connessione, clicca Esegui verifica.
Il plugin fa chiamate reali a Google e stampa le risposte. L'ultima sezione, Lettura, ti dice in parole semplici cosa fare.

Quando è tutto a posto dice: Tutto funziona: l'account di servizio vede 1 cartella condivisa. Ora puoi sceglierla con il pulsante Sfoglia accanto a una regola. Ora continua con Scegli chi vede quale cartella.

Altri pulsanti del riquadro Collega Google Drive

Sostituisci la chiave (prima apri Sostituisci la chiave con una nuova): scegli o incolla una nuova chiave al posto di quella salvata (per esempio dopo aver eliminato la vecchia chiave in Google Cloud).
Svuota cache: dimentica gli elenchi memorizzati dal plugin e li chiede di nuovo a Google.
Rimuovi la chiave: scollega il sito. Il portale resta spento finché non salvi una nuova chiave.

Installazione su più siti di clienti

Ogni sito dovrebbe usare il proprio progetto Google Cloud e il proprio account di servizio. Tra i siti non si condivide nulla e non bisogna modificare nulla nel codice: ogni sito mostra il proprio indirizzo con cui condividere la cartella.

Non hai trovato la risposta?

Scrivici indicando il plugin, cosa hai provato e cosa vedi. Rispondiamo dall’Italia, di solito entro un giorno lavorativo.

webadmin@nopvideo.com