Connecter Google Drive (configuration du compte de service)

Google Drive Portal se connecte à Google Drive avec un compte de service : une identité Google technique que vous créez gratuitement dans votre propre projet Google Cloud. Vous téléchargez sa clé (un petit fichier JSON), vous la donnez à l’extension et vous partagez un dossier Drive avec l’adresse du compte de service. L’ensemble de ce guide prend environ 10 minutes.

Avant de commencer

• Un compte Google qui peut ouvrir le dossier Drive à afficher (un compte Gmail classique ou un compte Google Workspace).
• L’extension installée et activée (voir Installer la version gratuite).
• Dans WordPress, ouvrez Drive Documents. Gardez cette page ouverte dans un onglet du navigateur : l’étape 1 de la page contient des liens directs vers les pages Google utilisées ci-dessous.

Étape A : créer un projet Google Cloud

Un projet est un conteneur dans Google Cloud qui regroupe vos réglages. Il est gratuit : cette extension utilise l’API Drive, qui ne coûte rien pour un usage normal.

1. Allez sur console.cloud.google.com/projectcreate et connectez-vous avec votre compte Google. Si c’est votre première visite, acceptez les conditions d’utilisation.
2. Dans Project name, saisissez un nom que vous reconnaîtrez, par exemple Documents du site.
3. Laissez les autres champs tels quels et cliquez sur Create.
4. Attendez quelques secondes, puis vérifiez que le nouveau projet est sélectionné dans le sélecteur de projets en haut de la console.

Vous pouvez aussi utiliser un projet existant.

Étape B : activer l’API Google Drive

1. Ouvrez la page de l’API Google Drive (ou, dans le menu de la console, APIs and services > Library, puis cherchez Google Drive API).
2. Vérifiez que votre projet est sélectionné en haut.
3. Cliquez sur Enable.

Si vous sautez cette étape, l’extension vous dira plus tard : The Google Drive API is not enabled on this project. (l’API Google Drive n’est pas activée sur ce projet).

Étape C : créer le compte de service

1. Ouvrez IAM and admin > Service accounts.
2. Cliquez sur Create service account.
3. Donnez-lui n’importe quel nom, par exemple wordpress-portal. Google remplit un ID pour vous.
4. Cliquez sur Create and continue.
5. Les écrans suivants demandent des rôles et des accès utilisateurs. N’accordez rien : cliquez simplement sur Continue puis sur Done. Le compte de service n’a besoin d’aucun rôle Cloud.

Étape D : télécharger la clé JSON

1. Dans la liste des comptes de service, cliquez sur celui que vous venez de créer.
2. Ouvrez l’onglet Keys.
3. Cliquez sur Add key > Create new key.
4. Choisissez JSON et cliquez sur Create.
5. Un fichier .json se télécharge sur votre ordinateur.

Étape E : donner la clé à l’extension

1. Revenez dans WordPress, Drive Documents, cadre 1. Create the Google service account.
2. Dans le champ JSON key, collez tout le contenu du fichier (ouvrez-le avec n’importe quel éditeur de texte et copiez tout, du premier { au dernier }), ou cliquez sur le bouton de fichier sous le champ et choisissez le fichier téléchargé.
3. Cliquez sur Save the key.

L’extension vérifie aussitôt la clé auprès de Google. Si tout fonctionne, vous voyez : Key saved and accepted by Google. Now share the Drive folder with ... , as Viewer. (clé enregistrée et acceptée par Google ; partagez maintenant le dossier Drive avec cette adresse, en lecture). Le cadre affiche alors Connected to Google Drive avec l’adresse du compte de service, qui ressemble à name@project-id.iam.gserviceaccount.com.

Étape F : partager le dossier Drive avec le compte de service

Le compte de service ne voit rien dans votre Drive tant que vous ne partagez pas un dossier avec lui. C’est le partage qui décide de ce que le portail peut afficher.

1. Sur la page de l’extension, dans le cadre 2. Share the Drive folder, cliquez sur Copy à côté de l’adresse du compte de service.
2. Ouvrez Google Drive et trouvez le dossier à afficher sur le site.
3. Faites un clic droit sur le dossier et choisissez Share (sur certains écrans Share > Share).
4. Collez l’adresse du compte de service dans le champ Add people.
5. Choisissez le rôle Viewer (lecteur). Viewer suffit : l’extension n’écrit jamais dans Drive.
6. Cliquez sur Send (ou Share). Si Google signale que l’adresse est extérieure à votre organisation, c’est normal : confirmez.
7. Revenez dans WordPress et rechargez la page Drive Documents. Le dossier apparaît dans la liste Folders shared with the service account.

Tout ce qui se trouve dans le dossier partagé est visible par l’extension, y compris les sous-dossiers et les fichiers ajoutés plus tard. Rien d’autre dans votre Drive ne l’est.

Étape G : lancer la vérification de connexion

1. Dans le cadre 1, sous Connection check, cliquez sur Run check.
2. L’extension effectue de vrais appels à Google et affiche la réponse. La dernière section, Reading, vous dit en langage clair quoi faire.

Quand tout va bien, elle indique : Everything works: the service account sees 1 shared folder. You can pick it with the Browse button in step 3. (tout fonctionne : le compte de service voit 1 dossier partagé, choisissez-le avec Browse à l’étape 3). Continuez maintenant avec Choisir qui voit quel dossier.

Les autres boutons du cadre 1

• Replace the key (remplacer la clé) : collez une nouvelle clé pour remplacer celle enregistrée (par exemple après avoir supprimé l’ancienne clé dans Google Cloud).
• Clear cache (vider le cache) : oublie les listes mémorisées par l’extension et réinterroge Google.
• Remove the key (supprimer la clé) : déconnecte le site. Le portail reste hors ligne jusqu’à l’enregistrement d’une nouvelle clé.

Installer sur plusieurs sites clients

Chaque site doit utiliser son propre projet Google Cloud et son propre compte de service. Rien n’est partagé entre les sites et rien n’est à modifier dans le code : chaque site affiche sa propre adresse avec laquelle partager le dossier.