Le but : Se connecter avec Google dans l'interface locale, puis indexer tout votre Drive ou des dossiers choisis, mis à jour toutes les 60 s (seuls les fichiers changés sont relus).
Il faut une fois un client OAuth « Application Web » (Google exige qu'une application soit déclarée pour lire Drive). C'est le seul usage de Google Cloud : un projet gratuit suffit, sans facturation ni service déployé.
Déjà fait pour le kit 1 ? Le même client convient : ajoutez simplement l'URI de redirection
http://localhost:8765/auth/google/callback(étape 4) et téléchargez à nouveau le JSON.
1. Créer le client OAuth (console Google Cloud, ≈ 5 min)
Projet quelconque (en créer un si besoin, gratuit) → API et services :
- Bibliothèque → Google Drive API → Activer.
- Google Auth Platform → Commencer : nom
RAG local, e-mail d'assistance, Audience : Externe (compte Gmail) ou Interne (Workspace) → Créer. - Audience → Utilisateurs test → ajoutez votre compte Google (Externe).
Accès aux données → ajoutez
.../auth/drive.readonly,openid,.../auth/userinfo.email. - Clients → Créer un client → Application Web :
- origine JavaScript :
http://localhost:8765; - URI de redirection :
http://localhost:8765/auth/google/callback; - Créer → Télécharger le JSON.
- origine JavaScript :
- Copiez le fichier :
cp ~/Téléchargements/client_secret_*.json gcp_rag/04-rag-local-claude/data/google_client.json(ou GOOGLE_CLIENT_FILE=/chemin/vers/client.json dans .env). Rechargez l'interface : le bouton
Se connecter avec Google apparaît.
2. Se connecter et choisir
- Se connecter avec Google → choisissez le compte → (Externe en test) « application non validée » → Continuer → cochez l'accès aux fichiers Drive.
- Sous le compte : Tout mon Drive (vos fichiers et ceux partagés avec vous) ou Choisir des dossiers : un sélecteur s'ouvre (Mon Drive, sous-dossiers, « Partagés avec moi »), cochez puis Ajouter.
- La source apparaît avec son interrupteur auto.
Conversion : Google Docs → .docx, Slides → .pptx, Sheets → .csv (première feuille). Les citations ouvrent
le document dans Drive.
3. À savoir
| Sujet | Détail |
|---|---|
| Jeton du compte | data/google_tokens.json (droits 600). Déconnecter (✕ sous le compte) le détruit et retire ses sources |
| Mode test : 7 jours | Application Externe en « Test » : Google expire la connexion après 7 jours → se reconnecter, ou Publier l'application (reste « non validée », 100 utilisateurs max). Interne (Workspace) : aucune limite |
| Pas de push | En local, Google ne peut pas joindre votre ordinateur : pas de notifications, mais une passe changes toutes les 60 s (une passe sans changement ne télécharge rien) |
| Gros Drive | 1re passe = lecture de tout ; ensuite seulement les changements. Réconciliation complète une fois par jour |
| Recouvrement | Évitez « Tout mon Drive » + un de ses dossiers : fichiers indexés deux fois |