API OneDrive : IA pour récupérer des liens depuis OneDrive

novembre 7, 2025

Data Integration & Systems

onedrive and microsoft — scope, stats and security

OneDrive se trouve au cœur du stockage de fichiers moderne pour de nombreuses entreprises et particuliers. Microsoft présente OneDrive comme un espace cloud qui relie le stockage personnel aux hubs d’entreprise. Pour être clair, OneDrive sert les comptes personnels tandis que SharePoint gère les sites d’équipe et les structures de dossiers partagés. Cette séparation importe lorsque vous choisissez où stocker des fichiers importants et lorsque vous concevez des politiques d’accès.

À grande échelle, OneDrive prend en charge une vaste base d’utilisateurs. Par exemple, il a été rapporté que OneDrive atteint plus de 500 millions d’utilisateurs actifs dans le monde, ce qui montre l’ampleur de l’environnement qu’une application ou une automatisation doit gérer (source). De plus, OneDrive voit des volumes quotidiens de contenu très importants ; des rapports indiquent plus d’un milliard de fichiers téléchargés chaque jour, ce qui souligne pourquoi tout système qui récupère des liens doit fonctionner rapidement et de manière fiable (source). Pour les entreprises, OneDrive et SharePoint jouent des rôles différents mais complémentaires : OneDrive stocke les fichiers individuels et le travail personnel, tandis que SharePoint conserve les fichiers d’équipe et le contenu partagé.

La sécurité et la conformité régissent le fonctionnement des liens. Microsoft chiffre les données au repos et en transit, et impose l’authentification multi‑facteurs et la DLP pour le contrôle du locataire. Microsoft déclare explicitement que les expériences connectées suivent des règles strictes de confidentialité, et que seules les données nécessaires sortent d’un locataire pour les fonctions d’IA (source). Les locataires doivent équilibrer la commodité et l’exposition. Par exemple, les liens anonymes réduisent les frictions mais augmentent le risque. Préférez les liens à la portée de l’organisation lorsque vous devez restreindre l’accès, et n’utilisez les liens anonymes que pour des ressources réellement publiques.

Les administrateurs peuvent auditer l’activité de partage. Des outils tels que Microsoft Graph Data Connect et les journaux d’audit vous permettent d’interroger l’ensemble des partages et de suivre qui a créé des liens. Utilisez ces outils pour signaler les liens anonymes et pour appliquer la rétention. Pour des conseils au niveau de l’environnement et des intégrations, ServiceNow et d’autres plateformes documentent des connecteurs OneDrive qui renvoient les événements dans les processus IT (source). Ce niveau d’intégration aide les équipes opérationnelles à réduire les vérifications manuelles et à maintenir la conformité.

Points pratiques : si vous souhaitez stocker vos fichiers pour une collaboration interne, choisissez des liens à la portée de l’organisation. Si vous devez partager avec des prestataires externes pour une courte période, utilisez des liens anonymes limités dans le temps et auditez-les. Enfin, lorsque vous concevez des solutions pour des équipes, souvenez‑vous que OneDrive est la référence pour le travail personnel et que SharePoint est le hub pour la collaboration d’équipe. Pour les équipes opérationnelles qui traitent de nombreux e‑mails et ont besoin d’un accès rapide aux fichiers, intégrer OneDrive avec des agents e‑mail peut considérablement réduire le temps de traitement ; voyez comment assistant virtuel pour la logistique accélère les réponses en ancrant les réponses dans des sources comme SharePoint et OneDrive.

microsoft onedrive api — createLink, permissions and response

L’API Microsoft OneDrive expose des actions que vous utilisez pour créer des liens de partage. Le point de terminaison principal pour la création de liens est l’action createLink. Utilisez le modèle POST pour créer ou renvoyer un lien existant : POST https://graph.microsoft.com/v1.0/drives/{driveId}/items/{itemId}/createLink. Le corps de la requête accepte du JSON simple tel que { « type »: »view », « scope »: »organization » } ou { « type »: »edit », « scope »: »anonymous » } pour générer des liens en lecture ou en écriture. Pour les ressources intégrables, utilisez le type « embed ».

Les réponses typiques incluent link.webUrl, link.type et link.scope. Notez que l’API renvoie un lien existant si une correspondance existe déjà, ce qui évite les URL anonymes en double. Les systèmes de production devraient donc vérifier les horodatages de réponse et réutiliser les liens lorsque c’est approprié. Pour la référence officielle de createLink et la forme JSON exacte, consultez la documentation Microsoft Graph pour driveItem createLink (les docs officielles fournissent des exemples complets et des notes sur les scopes).

Diagramme du flux de requêtes API

Les permissions comptent. N’utilisez que des scopes à privilèges minimaux. Les jetons délégués nécessitent typiquement Files.Read.All ou Files.ReadWrite.All lorsqu’ils agissent au nom d’un utilisateur. Pour les scénarios de service en mode app‑only, utilisez les scopes équivalents d’application tels que Sites.Read.All ou Sites.ReadWrite.All et assurez‑vous que les administrateurs du locataire consentent avant d’octroyer un large accès. De plus, préférez les endpoints v1.0 pour la production. Le chemin /beta peut offrir des fonctionnalités supplémentaires mais il change fréquemment et peut ne pas être stable pour des services à long terme.

Voici un exemple compact de corps de requête pour générer un lien de consultation à l’échelle de l’organisation :

POST https://graph.microsoft.com/v1.0/drives/{driveId}/items/{itemId}/createLink

Body: { « type »: « view », « scope »: « organization » }

Lorsque vous concevez une application qui appelle createLink, validez les permissions avant d’effectuer l’appel. Puis vérifiez link.scope et link.webUrl dans la réponse. Si un utilisateur n’a pas la permission de voir un fichier, votre application doit soit demander le consentement soit retourner une erreur utile à l’utilisateur afin qu’il puisse demander l’accès.

Checklist de sécurité : exiger le consentement du locataire pour les permissions larges d’application ; implémenter une piste d’audit pour les appels createLink ; éviter de générer des liens anonymes par défaut ; et appliquer de courtes expirations pour les liens externes. Pour en savoir plus sur les permissions et les schémas d’utilisation, voyez les guides techniques Microsoft et la référence des permissions Graph. Pour des scénarios réels de localisation et génération, Netwoven documente comment les outils de localisation de fichiers cartographient les éléments SharePoint et OneDrive, ce qui est utile quand vous voulez que l’application récupère du contenu existant de manière fiable (source). Enfin, gardez à l’esprit que le Graph peut renvoyer des liens existants, donc concevez votre mise en cache et votre logique de mise à jour de liens en conséquence.

Drowning in emails? Here’s your way out

Save hours every day as AI Agents draft emails directly in Outlook or Gmail, giving your team more time to focus on high-value work.

ai and copilot — how AI locates files and creates summaries

L’IA aide désormais à trouver des éléments et à générer du contexte. Les modèles d’IA analysent les requêtes naturelles et les mappent vers des identifiants de fichiers, des métadonnées ou des chemins. Le flux commence par la détection d’intention : le NLP extrait des noms de fichiers, des dates ou des concepts tels que « rapport du dernier trimestre ». L’IA interroge ensuite Microsoft Graph pour trouver des DriveItems correspondants et pour valider les permissions. Ensuite, le système réutilise soit un lien existant soit appelle createLink pour générer une nouvelle URL de partage.

Microsoft 365 Copilot et d’autres agents suivent ce schéma. Copilot appelle Microsoft Graph, respecte les politiques du locataire et peut produire un court résumé d’IA qui accompagne un lien. Par exemple, vous pouvez demander à Copilot « Créer un lien récapitulatif partageable pour le rapport du dernier trimestre » et Copilot localisera le document, confirmera l’accès, générera un lien, puis résumera les points clés. Microsoft a déclaré que les expériences connectées n’envoient que ce qui est nécessaire et qu’elles respectent les règles de confidentialité du locataire (source). Cela aide à garantir qu’aucune donnée excessive ne quitte le locataire.

Cas d’usage pratique : vous recevez un e‑mail demandant des chiffres de ventes. Votre agent IA interprète la demande, recherche dans OneDrive des documents avec des titres correspondants, vérifie que le demandeur a les droits, crée ou renvoie un lien en consultation puis résume les chiffres clés. Cela améliore la rapidité de réponse et réduit les erreurs. Pour les équipes qui traitent de nombreux e‑mails entrants, cette automatisation se traduit directement par des gains de productivité ; nos clients observent une forte réduction du temps de traitement lorsque l’IA source des documents faisant autorité et rédige des réponses ancrées dans ces fichiers comment améliorer le service client logistique grâce à l’IA.

Des limites subsistent. L’IA a du mal avec des requêtes ambiguës, des noms de fichiers dupliqués et des manques de permissions. Si plusieurs fichiers correspondent à une requête, l’IA devrait présenter des options plutôt que de deviner. De plus, si l’utilisateur n’a pas accès, l’IA ne peut pas forcer l’autorisation ; elle doit solliciter une approbation. Enfin, faites attention aux règles de manipulation des données lorsque vous utilisez des services d’IA externes comme OpenAI ou Azure OpenAI ; assurez‑vous de configurer des restrictions au niveau du locataire et vérifiez que les résumés ne divulguent pas de sections sensibles des documents. Pour les futures fonctionnalités IA et mises à jour de la plateforme, le blog de Microsoft met en lumière des travaux visant à améliorer la gestion de contenu dans SharePoint et OneDrive lors de mises à jour à venir (source). Utilisez ces signaux lors de la planification d’améliorations intégrant Copilot ou des services basés sur GPT.

file and onedrive files — identifiers, metadata and permissions for accurate fetching

La précision des récupérations dépend d’identifiants stables et de métadonnées riches. L’identifiant le plus fiable est la combinaison driveId et itemId. Vous pouvez aussi utiliser l’adressage par chemin avec /root:/path/to/file si vous préférez des requêtes lisibles par l’humain. Cependant, les chemins se rompent quand les fichiers sont déplacés ou quand des dossiers sont renommés. Pour ces raisons, privilégiez les IDs stables pour les récupérations programmatiques. Utilisez l’expression onedrive files lorsque vous décrivez des API qui renvoient des collections d’éléments dans un drive.

Les champs de métadonnées utiles incluent name, lastModifiedDateTime, owner, size, file hashes et sharing status. Ces champs aident à désambiguïser les résultats. Par exemple, vérifiez lastModifiedDateTime et owner pour sélectionner la version la plus récente lorsque des noms sont en double. De plus, les hashes de fichiers ou les ETags détectent les modifications afin que vous ne rafraîchissiez les résumés que lorsque le contenu change effectivement. Quand un agent IA doit extraire un contenu spécifique, incluez contentType et les données MIME afin de traiter de manière cohérente les PDF, les feuilles Excel ou l’audio. Si vous devez extraire du texte depuis des PDF ou de l’audio, prévoyez une étape d’extraction qui convertit l’actif en texte interrogeable avant la summarisation.

Les contrôles de permission sont nécessaires. Vérifiez que l’utilisateur demandeur a un accès en lecture avant de générer un lien. Pour un accès par utilisateur, utilisez l’API invite pour accorder un accès explicite plutôt que de compter sur des liens anonymes. Les liens à la portée de l’organisation réduisent l’exposition, tandis que les liens anonymes simplifient le partage externe mais augmentent la charge d’audit. Surveillez les liens orphelins provenant d’éléments déplacés ou supprimés ; implémentez des analyses régulières pour détecter les liens brisés et les régénérer ou révoquer si nécessaire.

Voici une checklist pour l’appariement des requêtes IA :

1) Extraire l’intention et les mots‑clés de recherche. 2) Essayer d’abord la recherche par ID (driveId + itemId). 3) Si pas d’ID, lancer une requête par chemin (/root:/path). 4) Si des noms renvoient plusieurs correspondances, filtrer par lastModifiedDateTime et owner. 5) Vérifier le statut de partage et les permissions. 6) Si pas d’accès, fournir un workflow pour demander la permission.

Exemple de requête Graph par chemin pour trouver un fichier : GET /drives/{driveId}/root:/Reports/2025/Q1.pdf. Requête par id : GET /drives/{driveId}/items/{itemId}. Pour les drives partagés et les comptes personnels, souvenez‑vous que les formats de driveId diffèrent. Aussi, lorsque vous devez référencer des fichiers individuels dans des journaux ou des événements de changement, stockez des valeurs itemId stables afin que votre IA puisse toujours récupérer le bon actif. Pour l’automatisation qui interagit avec des documents et des fichiers, les IDs stables évitent de nombreux cas limites.

Drowning in emails? Here’s your way out

Save hours every day as AI Agents draft emails directly in Outlook or Gmail, giving your team more time to focus on high-value work.

app and integrate — building an app to fetch links and integrate into workflows

Concevoir une application qui récupère des liens implique quelques composants cohérents. D’abord, gérer l’authentification. Utilisez le flux délégué OAuth 2.0 pour les applications destinées aux utilisateurs et les client credentials pour les services en arrière‑plan. Ensuite, implémentez un backend qui appelle Microsoft Graph. Le backend doit valider les permissions, appeler createLink, mettre en cache les résultats et consigner les actions. De plus, gardez les jetons sécurisés et faites leur rotation selon les bonnes pratiques.

Schéma d'architecture des interactions entre l'application utilisateur et le cloud

La couche IA peut utiliser Azure OpenAI ou d’autres modèles pour interpréter les requêtes et résumer le contenu. Nous recommandons de combiner la recherche Graph avec un résumé IA qui produit de courts abstracts et des points d’action. Après que l’IA ait généré un résumé, joignez‑le au lien et renvoyez les deux à l’utilisateur. Cette méthode aide les utilisateurs à parcourir rapidement les fichiers importants sans ouvrir chaque document.

Les points d’intégration incluent Teams, Outlook, SharePoint et d’autres applications comme les CRM. Par exemple, ajoutez un bouton dans Outlook qui déclenche l’application pour localiser et joindre un lien de partage. Pour les équipes logistiques, connecter l’application aux agents e‑mail résout un problème courant : les agents ont besoin de trouver et citer des fichiers lors de la rédaction de réponses. Notre propre plateforme correspondance logistique automatisée intègre plusieurs sources et rédige des réponses contextuelles, ce qui réduit le temps de traitement des e‑mails répétitifs et aide les équipes à rester cohérentes.

Diagramme de séquence en mots : Utilisateur → front end de l’app → backend de l’app valide le token → le backend interroge Microsoft Graph pour l’élément → si besoin le backend appelle createLink → le backend stocke le lien et les métadonnées en cache → le summariseur IA récupère le contenu → l’IA retourne un résumé → l’app présente le lien plus le résumé à l’utilisateur. Ce flux prend en charge à la fois les réponses synchrones et les résumés mis en file pour les gros PDF ou classeurs Excel.

Conseils d’implémentation : implémentez la reprise avec backoff exponentiel pour les erreurs Graph transitoires, préférez les endpoints v1.0 en production, et demandez des scopes minimaux pour réduire l’exposition. Conservez des journaux pour l’audit et pour permettre des retours en arrière. Pour un accès sécurisé aux fichiers et pour permettre l’automatisation, concevez l’application pour respecter les politiques du locataire et pour exposer les problèmes de permissions comme des workflows humains afin que les utilisateurs puissent demander l’accès. Lors de la construction d’intégrations pour le service client ou les opérations, n’oubliez pas d’inclure la citation contextuelle et de permettre la personnalisation afin que les équipes puissent adapter la rédaction des messages et la gestion des liens. Pour des exemples détaillés sur la manière dont l’IA réduit le temps de traitement des e‑mails en logistique, consultez nos pages qui décrivent des études de cas et des métriques ROI comment faire évoluer les opérations logistiques sans embaucher.

Séquence recommandée : implémentez la reprise et la gestion des limites, mettez en cache intelligemment, et exposez des workflows de demande d’accès lorsque nécessaire.

Conseils d’implémentation supplémentaires : en cas d’erreurs transitoires, appliquez un backoff exponentiel ; batcher les opérations quand c’est possible ; et répartir les synchronisations lourdes dans le temps pour éviter d’atteindre les seuils de throttling. Stockez des logs détaillés pour l’audit et la possibilité de rollback. Pour des informations plus poussées, voyez les ressources et études de cas liées à l’IA et à l’automatisation.

automate and workflow — webhooks, change notifications, monitoring and best practice

L’automatisation maintient les liens à jour et réduit les vérifications manuelles. Utilisez les notifications de changement et les webhooks pour détecter les événements DriveItem tels que les déplacements, les renommages, les modifications de permissions et les suppressions. S’abonner aux notifications de changement DriveItem permet à votre application de réagir en quasi‑temps réel. Parallèlement, utilisez les requêtes delta Graph pour une synchronisation efficace afin de trouver ce qui a changé depuis votre dernière vérification. Les requêtes delta réduisent la bande passante et garantissent que vous ne traitez que le contenu onedrive modifié.

Choix de conception : les mises à jour pilotées par événements réagissent rapidement, tandis que les analyses programmées fournissent un filet de sécurité. Combinez les deux. Par exemple, utilisez les webhooks pour marquer les éléments modifiés et exécutez un job programmé pour valider les liens en cache une fois par jour. Lorsque vous détectez un fichier déplacé ou un élément orphelin, validez le lien en cache et régénérez‑le uniquement si nécessaire. Également, implémentez une politique pour révoquer les liens anonymes plus anciens qu’un seuil et réémettre des liens à portée organisationnelle pour les partenaires qui doivent maintenir un accès continu.

Surveillez et gouvernez les liens de partage. Auditez régulièrement l’activité createLink et signalez les liens anonymes. Utilisez les politiques du locataire pour bloquer la génération de liens anonymes lorsque la conformité l’exige. Implémentez des alertes pour les pics soudains de partages externes. Pour les limites de fréquence, gérez les réponses 429 avec un backoff exponentiel. Microsoft documente le comportement de throttling du Graph ; gérez‑le avec grâce et mettez en file les réessais pour éviter d’atteindre les limites lors d’opérations en masse. ServiceNow et d’autres plateformes montrent des schémas d’intégration des notifications et des automatisations dans les processus IT (source).

Checklist des bonnes pratiques : appliquer le principe du moindre privilège, consigner tous les événements de partage, exiger le consentement utilisateur pour les applications à large portée, scanner régulièrement les liens anonymes, et préférer les liens à la portée de l’organisation quand c’est possible. Pour les runbooks opérationnels, suivez ces étapes : Détecter via webhook → Valider l’élément et les permissions → Régénérer un lien si l’original est brisé → Notifier les propriétaires et demander approbation si les permissions ont changé. Ce court runbook aide les équipes opérations à garder les liens précis et sûrs.

Enfin, soyez attentif à la conformité et à la gestion des données dans les pipelines IA. Lorsque vous envoyez des extraits de documents à des modèles comme ceux d’OpenAI ou d’Azure OpenAI, assurez‑vous d’avoir les garanties contractuelles et techniques appropriées. Les recommandations de confidentialité de Microsoft constituent un socle pour les expériences connectées (source). Pour les équipes qui veulent automatiser la récupération de fichiers et les réponses dans les e‑mails, combiner webhooks, synchronisation delta et summarisation IA fournit un modèle fiable pour rationaliser la gestion des fichiers et réduire le travail manuel. Si vous avez besoin d’une solution clé en main qui relie OneDrive et l’e‑mail pour les opérations, explorez des solutions intégrées et des connecteurs conçus pour les équipes logistiques et de support rédaction d’e-mails logistiques avec IA.

FAQ

How does OneDrive differ from SharePoint for storing files?

OneDrive est généralement destiné au stockage personnel et aux fichiers individuels, tandis que SharePoint est destiné aux sites d’équipe et aux structures de dossiers partagés. Utilisez OneDrive pour les brouillons et le travail personnel, et SharePoint pour les documents collaboratifs et les bibliothèques partagées.

What is the createLink action in the Microsoft Graph?

L’action createLink est un endpoint Graph qui génère une URL partageable pour un DriveItem. Elle accepte un type et une portée, et la réponse contient link.webUrl, link.type et link.scope. Si un lien correspondant existe déjà, l’API renverra souvent le lien existant.

Which permissions do I need to create sharing links?

Les applications déléguées ont normalement besoin de Files.Read.All ou Files.ReadWrite.All lorsqu’elles agissent en tant qu’utilisateur. Les services en mode app‑only utilisent Sites.Read.All ou Sites.ReadWrite.All. Appliquez toujours le principe du moindre privilège et demandez le consentement de l’administrateur du locataire pour des scopes larges.

How does AI locate files in OneDrive?

L’IA utilise le NLP pour analyser l’intention de l’utilisateur puis interroge Microsoft Graph pour des DriveItems correspondants par ID, chemin ou métadonnées. Une fois qu’un fichier est identifié, l’IA vérifie les permissions, appelle createLink si nécessaire, et peut produire un court résumé pour accompagner le lien.

Can Copilot create links and summarise documents?

Oui, Microsoft 365 Copilot appelle Microsoft Graph et peut créer un lien partageable et produire un résumé. Copilot respecte les politiques du locataire et ne présentera que le contenu auquel l’utilisateur peut accéder. Vérifiez toujours les paramètres de confidentialité avant de partager du contenu sensible.

What should I do about duplicate file names?

Utilisez driveId + itemId pour référencer de manière fiable, et utilisez des filtres de métadonnées comme lastModifiedDateTime et owner pour sélectionner le fichier correct lorsque les noms se chevauchent. Les IDs stables évitent l’ambiguïté lorsque les fichiers sont déplacés ou renommés.

How do I keep cached links current?

Abonnez‑vous aux notifications de changement DriveItem et utilisez les requêtes delta Graph pour détecter les modifications. Lorsqu’un changement se produit, validez le lien en cache, régénérez‑le s’il est brisé, et notifiez les propriétaires si nécessaire. Cette approche équilibre les mises à jour en temps réel avec une validation programmée.

Are anonymous links safe to use?

Les liens anonymes sont pratiques mais augmentent le risque d’exposition. Préférez les liens à la portée de l’organisation pour le partage interne et n’utilisez les liens anonymes que pour des partages externes à court terme avec des expirations strictes et des audits. Scannez régulièrement les liens anonymes et révoquez‑les s’ils ne sont plus nécessaires.

How do I handle Graph rate limits in an app that fetches links?

Implémentez un backoff exponentiel pour les réponses 429, mettez en file les réessais, et utilisez les requêtes delta pour réduire le nombre de requêtes. De plus, batcher les opérations quand c’est possible et étaler les synchronisations lourdes dans le temps pour éviter d’atteindre les seuils de throttling.

Can AI extract and summarise content from PDFs and Excel files?

Oui. Convertissez d’abord les PDF ou les feuilles Excel en texte interrogeable ou en données structurées, puis exécutez un summariseur IA sur le contenu extrait. Pour les fichiers volumineux ou complexes, traitez‑les par étapes et mettez en cache les résultats pour éviter des extractions répétées.

Ready to revolutionize your workplace?

Achieve more with your existing team with Virtual Workforce.