Intégration API Google Drive
Nous développons votre connecteur Google Drive
Nous relions votre dossier métier à l'API Google Drive pour déposer, exporter et réagir à un fichier, avec drive.file plus Picker plutôt qu'un scope restreint.
- Équipe produit senior
- connecteurs Drive en production
- du cadrage au monitoring
À quoi sert l'API Google Drive et pourquoi l'intégrer dans un logiciel métier ?
Google Drive est le stockage de fichiers de référence pour des millions d'entreprises qui travaillent dans l'écosystème Google Workspace. Son API permet à votre application de déposer des fichiers dans un Drive spécifique, d'écouter les ajouts ou modifications de documents et de les traiter automatiquement, et d'exporter des Sheets ou Docs vers votre logiciel. On l'intègre pour que les devis, contrats ou rapports générés par votre application soient automatiquement enregistrés dans le dossier Drive du client, sans que les équipes basculent entre les outils.
Ce que nos clients construisent sur l'API Google Drive
Portail avec Picker, pas tout le Drive
L'utilisateur choisit le fichier. drive.file suffit. Pas d'évaluation de sécurité de six mois pour un dépôt de pièce.
Dossier d'affaire dans un shared drive
Création du dossier, PDF poussés, réaction à un contrat signé déposé par le commercial. Mon Drive seul rate le SI réel.
Export comptable depuis Sheets
files.export en CSV ou PDF vers l'ERP. Le tableau reste un Doc Google, le flux métier reçoit un fichier lisible.
Dossier « arrivée » sous files.watch
Un PDF déposé dans le dossier d'arrivée crée l'affaire. On réagit au contenu, aux droits ou au déplacement, sans surveiller en boucle.
Ce que ça change dans vos fichiers Workspace
La technique au service d'un résultat mesurable : la pièce dans le dossier, un scope signable, moins de liens morts.
Vous ne demandez pas tout le Drive
L'utilisateur choisit le fichier dans le sélecteur. C'est souvent le seul chemin compatible avec un délai de mise en production.
Docs et Sheets deviennent exploitables
L'export vers PDF ou CSV fait partie du connecteur. Un « télécharger tout » sans export natif rate le cœur du parc Google.
Les drives partagés sont le SI
On cible le drive d'équipe dès le cadrage. Une démo sur Mon Drive qui échoue chez le client, on ne la livre pas.
Le quota ne tue pas le parcours
Les lectures sont cadencées. Un crawl naïf épuise le compte utilisateur bien avant la limite projet.
Comment nous livrons votre connecteur Google Drive
Cadrage
drive.file ou scope restreint (éligibilité, audit), Picker, shared drives, export Docs. On refuse « on synchronise tout » sans dossier de sécurité.
Développement
startPageToken persisté, watch renouvelé, compteur d'unités 5/50/100/200, upload repris au-delà de 5 Mo, branche export et raccourcis.
Recette
Doc vs PDF, shared drive sans supportsAllDrives, canal expiré, jeton changes rejeté, 750 Go/jour. Rejeu avant bascule.
Monitoring
Alerte 403/429, canal mort, unités/minute. Procédure de révocation quand le client part. Refresh tokens chiffrés hors dépôt.
Ce que permet l'API Google Drive
- Fichiers, dossiers, shared drives
- files, drives, permissions, revisions. Raccourcis (shortcut) et dossiers n'ont pas de binaire. appDataFolder pour l'état applicatif invisible dans l'UI.
- Trois modes d'upload
- media et multipart jusqu'à 5 Mo. resumable au-delà, ou dès qu'une coupure est probable. L'URI de session expire au bout d'une semaine.
- Export des fichiers Google
- files.export vers un MIME. alt=media ne télécharge pas un Doc comme un PDF. C'est la branche qui sépare un connecteur Workspace d'un tutoriel fichiers.
- Journal changes et push
- getStartPageToken puis changes.list. watch sur un fichier ou sur le journal (pageToken obligatoire). Corps vide, X-Goog-Changed parfois présent sur files.watch.
Le vocabulaire de l'API Google Drive
- drive.file
- Scope non sensible : uniquement les fichiers ouverts ou créés par l'app. Couplé au Picker, c'est le chemin de production. drive et drive.readonly sont restreints.
- startPageToken
- Curseur du journal changes. On persiste newStartPageToken. Un jeton rejeté impose une reprise complète, comme un 410 Calendar.
- X-Goog-Changed
- Sur files.watch : content, properties, parents, children, permissions. Sur changes.watch, l'état est change : il faut relire le journal. Corps toujours vide.
- files.export
- Seule façon de sortir un Doc/Sheet/Slide. alt=media ne s'applique pas aux types Google. MIME d'export cadré au projet (PDF, CSV, DOCX).
- Unités
- Lecture 5, édition 50, listage 100, téléchargement 200. Ce n'est plus « des requêtes par seconde ». 750 Go d'upload/jour/utilisateur Workspace, fichier max 5 To.
- supportsAllDrives
- Paramètre obligatoire dès qu'un shared drive entre en jeu, avec driveId / corpora / includeItemsFromAllDrives. L'oublier, c'est une démo Mon Drive.
Les contraintes réelles de l'API Google Drive
Les scopes larges sont restreints
drive, drive.readonly, metadata, activity : évaluation de sécurité si vous stockez ou transmettez hors Google, et catégories d'apps éligibles seulement. Promettre « tout le Drive » sans ce budget arrête le projet au consentement OAuth.
La notification est vide
Même famille que Calendar. Pas de HMAC. Handler : valider le token, enfiler, 2xx. Relecture via changes.list. Aucun renouvellement automatique de canal.
Le listage est cher
files.list = 20 × files.get. Un crawl récursif brûle 325 000 unités/min/user. fields=* en production est un anti-pattern. Backoff tronqué selon le guide limits Google.
quotaUser ne sauve pas Drive authentifié
Pour Drive avec jeton, le quota suit le jeton, pas quotaUser (réservé à l'anonyme sur fichiers publics). Un compte de service en délégation reste un seul utilisateur. Facturation 2026 à chiffrer dans le TCO.
API Google Drive ou API SharePoint ?
Deux disques d'entreprise. Le bon dépend du Workspace ou du locataire Microsoft déjà là.
| Critère | Google DriveCette page | Microsoft 365Graph fichiers |
|---|---|---|
| Parc typique | Workspace, shared drives | SharePoint / OneDrive du locataire |
| Périmètre fin | drive.file + Picker | Sites.Selected + POST /permissions |
| Fichiers bureautique | export MIME obligatoire (Docs/Sheets) | binaires et Office dans le drive |
| Incrément | changes.list + startPageToken | delta query + deltaLink |
| Signature push | Aucune HMAC, token de canal | Abonnement Graph, 202 d'abord |
| Upload repris | dès 5 Mo, URI 7 jours | dès ~10 Mio, multiples 320 Kio |
| Le bon cas | L'entreprise est déjà sur Workspace | L'entreprise est déjà sur Microsoft 365 |
Box et Dropbox se discutent si la GED n'est ni Drive ni SharePoint. Sheets n'est un livrable que si le tableau est vraiment le document.
Ce que nous mesurons sur une intégration Google Drive
Les autres API de fichiers
Si le parc n'est pas Workspace, ces options se discutent au cadrage.
Google DriveNous développons votre connecteur Google DriveCette page
Microsoft 365SharePoint et OneDrive via Graph, Sites.Selected.
BoxGED entreprise, webhooks HMAC, App Users.
DropboxPartage de fichiers, curseur list_folder, App Folder.On combine Google Drive avec
La stack qui entoure Drive sur nos projets.
Intégration Google Drive : vos questions
OAuth avec le scope le plus étroit possible (drive.file plus Picker par défaut), client qui envoie fields, branche export pour les types Google, upload resumable au-delà de 5 Mo, journal changes plus watch pour le temps réel. supportsAllDrives dès qu'un shared drive existe. Compteur d'unités côté client. La partie sensible n'est pas files.create, c'est le scope restreint que l'on n'a pas promis, et un canal push sans HMAC.
Le défaut sain est drive.file, non sensible, limité aux fichiers de l'app, collé au Picker. drive.appdata sert à l'état applicatif. drive et drive.readonly sont restreints : évaluation de sécurité, catégories d'apps éligibles (sauvegarde, productivité, reporting). Promettre une sync totale sans ce dossier, c'est un projet arrêté au consentement. Google pousse d'ailleurs la migration vers drive.file.
Un premier flux utile, typiquement dépôt via Picker et rattachement au dossier métier, se livre en deux à trois semaines. Un connecteur GED (changes, watch, export, shared drives, compteur d'unités) demande plutôt six à huit semaines. Un scope restreint ajoute le calendrier d'audit Google, souvent plus long que le code. Nous le disons au cadrage. C'est un arbitrage de cadrage, écrit avant le premier appel, pas une surprise de recette.
On suit le tenant. Workspace : Drive v3. Microsoft 365 : Graph fichiers (page Microsoft 365). Les deux ont un incrément et un push à relecture. Drive exige files.export pour Docs/Sheets ; SharePoint parle unités et Sites.Selected. Box et Dropbox si la GED est déjà ailleurs. C'est un arbitrage de cadrage, écrit avant le premier appel, pas une surprise de recette. Box et Dropbox se discutent si la GED est déjà ailleurs, hors des deux suites bureautiques.
Pas avec files.get alt=media. Un Doc, Sheet ou Slide se sort par files.export vers un MIME (PDF, DOCX, CSV, etc.). Les raccourcis se suivent via shortcutDetails.targetId. Les dossiers n'ont pas de contenu binaire. Un connecteur qui « télécharge tout » sans cette branche est faux sur le parc Workspace, même s'il passe la démo sur un PDF. C'est un arbitrage de cadrage, écrit avant le premier appel, pas une surprise de recette.
Un projet d'intégration Google Drive ?
Parlons-en. 30 minutes pour cadrer Picker, scopes, shared drives, et vous dire franchement si un scope restreint est tenable.
Parler de mon projet Drive