OneDrive-API: AI om links uit OneDrive op te halen

november 7, 2025

Data Integration & Systems

onedrive and microsoft — scope, stats and security

OneDrive staat centraal in moderne bestandsopslag voor veel bedrijven en individuen. Microsoft positioneert OneDrive als een cloudopslag die persoonlijke opslag met zakelijke hubs verbindt. Ter verduidelijking: OneDrive bedient persoonlijke accounts terwijl SharePoint teamsites en gedeelde mappenstructuren afhandelt. Deze splitsing is belangrijk bij het kiezen waar je belangrijke bestanden opslaat en bij het ontwerpen van toegangsbeleid.

Op schaal ondersteunt OneDrive een grote gebruikersbasis. Zo is gerapporteerd dat OneDrive meer dan 500 miljoen actieve gebruikers wereldwijd bereikt, wat de schaal aangeeft van de omgeving waarmee een app of automatisering moet omgaan (bron). Ook verwerkt OneDrive zeer grote dagelijkse hoeveelheden content; rapporten noteren meer dan een miljard bestanden die dagelijks worden geüpload, wat benadrukt waarom elk systeem dat links ophaalt snel en betrouwbaar moet werken (bron). Voor ondernemingen spelen OneDrive en SharePoint verschillende maar complementaire rollen: OneDrive slaat individuele bestanden en persoonlijk werk op, terwijl SharePoint teambestanden en gedeelde content bewaart.

Beveiliging en compliance bepalen hoe links werken. Microsoft versleutelt data in rust en tijdens transport, en dwingt multi-factor authenticatie en DLP af voor tenantcontrole. Microsoft stelt expliciet dat connected experiences strikte privacyregels volgen en dat alleen noodzakelijke gegevens de tenant verlaten voor AI-functies (bron). Tenants moeten gemak afwegen tegen blootstelling. Anonieme links verminderen bijvoorbeeld frictie maar verhogen risico. Geef de voorkeur aan links met organisatiebereik wanneer je toegang wilt beperken, en gebruik anonieme links alleen voor echt openbare bronnen.

Beheerders kunnen deelactiviteiten auditen. Hulpmiddelen zoals Microsoft Graph Data Connect en auditlogs stellen je in staat de deeldataset te doorzoeken en bij te houden wie links heeft gemaakt. Gebruik die tools om anonieme links te markeren en om retentie af te dwingen. Voor omgevingsniveau-advies en integraties documenteren ServiceNow en andere platforms OneDrive-connectors die gebeurtenissen terugkoppelen naar IT-processen (bron). Dit niveau van integratie helpt operationele teams handmatige controles te verminderen en compliance te behouden.

Praktische punten: als je je bestanden wilt opslaan voor interne samenwerking, kies dan links met organisatiebereik. Als je tijdelijk met externe aannemers moet delen, gebruik dan tijdsgebonden anonieme links en audit deze. Ten slotte, wanneer je oplossingen ontwerpt voor teams, onthoud dat OneDrive de voorkeur heeft voor persoonlijk werk en SharePoint de hub is voor teamcollaboratie. Voor operationele teams die veel e-mails afhandelen en snel toegang tot bestanden nodig hebben, kan het integreren van OneDrive met e-mailagenten de verwerkingstijd aanzienlijk verkorten; zie hoe virtuele assistent voor logistiek antwoorden versnelt door antwoorden te funderen op bronnen zoals SharePoint en OneDrive.

microsoft onedrive api — createLink, permissions and response

De Microsoft OneDrive API biedt acties die je gebruikt om deelbare links te maken. Het kernendpoint voor het maken van links is de createLink-actie. Gebruik het POST-patroon om een nieuwe link te maken of een bestaande link te retourneren: POST https://graph.microsoft.com/v1.0/drives/{driveId}/items/{itemId}/createLink. De request-body accepteert eenvoudige JSON zoals { “type”:”view”, “scope”:”organization” } of { “type”:”edit”, “scope”:”anonymous” } om view- of edit-links te genereren. Voor embedbare assets gebruik je type “embed”.

Typische responses bevatten link.webUrl, link.type en link.scope. Let op dat de API een bestaande link retourneert als er al een match bestaat, wat dubbele anonieme URL’s voorkomt. Productiesystemen moeten daarom responstimestamps controleren en links hergebruiken waar passend. Voor de officiële createLink-referentie en de exacte JSON-vorm, raadpleeg de Microsoft Graph-docs voor driveItem createLink (de officiële docs bieden volledige voorbeelden en opmerkingen over scopes).

API-aanvraagstroomdiagram

Permissies zijn van belang. Gebruik alleen scopes met de minste privileges. Gedecentraliseerde tokens (delegated) hebben doorgaans Files.Read.All of Files.ReadWrite.All nodig wanneer ze namens een gebruiker handelen. Voor app-only service-scenario’s gebruik je de equivalente app-scopes zoals Sites.Read.All of Sites.ReadWrite.All en zorg je dat tenantbeheerders toestemming geven voordat je brede toegang verleent. Geef ook de voorkeur aan v1.0-endpoints voor productie. Het /beta-pad kan extra functies bieden maar verandert vaak en is mogelijk niet stabiel voor lange termijndiensten.

Hier is een compact voorbeeld van een request-body om een organization view-link te genereren:

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

Body: { “type”: “view”, “scope”: “organization” }

Wanneer je een app ontwerpt die createLink aanroept, valideer dan permissies voordat je de call uitvoert. Controleer daarna link.scope en link.webUrl in de response. Als een gebruiker geen toestemming heeft om een bestand te bekijken, moet je app ofwel toestemming aanvragen of een nuttige foutmelding teruggeven zodat de gebruiker om toegang kan vragen.

Beveiligingschecklist: vereis tenanttoestemming voor brede app-permissies; implementeer een audittrail voor createLink-aanroepen; vermijd standaard het genereren van anonieme links; en implementeer korte vervaldata voor externe links. Voor meer over permissies en gebruikspatronen, zie Microsoft technische richtlijnen en de Graph permission reference. Voor echte locate-and-generate-scenario’s documenteert Netwoven hoe file-locator-tools map naar SharePoint- en OneDrive-items, wat nuttig is als je wilt dat de app bestaande content betrouwbaar ophaalt (bron). Houd tenslotte in gedachten dat de Graph bestaande links kan teruggeven, dus ontwerp je caching- en link-update-logica dienovereenkomstig.

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

AI helpt nu bij het vinden van items en het genereren van context. AI-modellen ontleden natuurlijke vragen en zetten die om naar bestandidentificatoren, metadata of paden. De flow begint met intent-detectie: NLP haalt bestandsnamen, datums of concepten zoals “last quarter’s report” eruit. De AI vraagt vervolgens Microsoft Graph om overeenkomende DriveItems te vinden en valideert permissies. Daarna hergebruikt het systeem ofwel een bestaande link of roept het createLink aan om een nieuwe deel-URL te genereren.

Microsoft 365 Copilot en andere agents volgen dit patroon. Copilot roept Microsoft Graph aan, respecteert tenantbeleid en kan een korte AI-samenvatting produceren die een link vergezelt. Bijvoorbeeld, je kunt Copilot vragen om “Create a shareable summary link for last quarter’s report” en Copilot zal het document vinden, toegang bevestigen, een link genereren en vervolgens de belangrijkste punten samenvatten. Microsoft heeft aangegeven dat connected experiences alleen het noodzakelijke verzenden en dat ze voldoen aan tenant privacyregels (bron). Dit is nuttig wanneer je wilt waarborgen dat er geen overtollige gegevens de tenant verlaten.

Praktisch voorbeeld: je ontvangt een e-mail met het verzoek om verkoopcijfers. Je AI-agent interpreteert het verzoek, zoekt in OneDrive naar documenten met overeenkomende titels, controleert dat de verzoeker rechten heeft, creëert of retourneert een view-link en vat daarna de belangrijkste cijfers samen. Dit verbetert de responssnelheid en vermindert fouten. Voor teams die veel inkomende e-mails afhandelen, leidt dergelijke automatisering direct tot productiviteitswinst; onze klanten zien sterke dalingen in verwerkingstijd wanneer AI gezaghebbende documenten haalt en antwoorden opstelt op basis van die bestanden hoe je logistieke klantenservice met AI kunt verbeteren.

Beperkingen blijven bestaan. AI heeft moeite met vage queries, dubbele bestandsnamen en permissiekloofjes. Als meerdere bestanden overeenkomen met een query, moet de AI opties presenteren in plaats van te raden. Ook kan de AI geen toegang afdwingen als de gebruiker geen rechten heeft; hij moet om goedkeuring vragen. Wees tenslotte zorgvuldig met gegevensverwerking bij het gebruik van externe AI-diensten zoals OpenAI of Azure OpenAI; zorg dat je tenantniveau-beperkingen configureert en verifieer dat samenvattingen geen gevoelige gedeelten van documenten lekken. Voor aankomende AI-functionaliteit en platformupdates belicht Microsoft’s blog werk om contentbeheer in SharePoint en OneDrive in toekomstige updates te verbeteren (bron). Gebruik die signalen bij het plannen van verbeteringen die Copilot of GPT-gebaseerde services integreren.

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

Nauwkeurige ophalen hangt af van stabiele identificatoren en rijke metadata. De meest betrouwbare identifier is de combinatie van driveId en itemId. Je kunt ook padgebaseerde adressering gebruiken met /root:/path/to/file als je mensleesbare queries verkiest. Paden breken echter wanneer bestanden verplaatst worden of wanneer mappen worden hernoemd. Om deze redenen geef je programmatisch de voorkeur aan stabiele IDs. Gebruik de term onedrive files wanneer je API’s beschrijft die verzamelingen items in een drive retourneren.

Nuttige metadata-velden zijn onder andere name, lastModifiedDateTime, owner, size, file hashes en sharing status. Deze velden helpen resultaten te onderscheiden. Controleer bijvoorbeeld lastModifiedDateTime en owner om de meest recente versie te selecteren wanneer namen dubbel voorkomen. Ook detecteren file hashes of ETags wijzigingen zodat je samenvattingen alleen ververst wanneer de inhoud daadwerkelijk verandert. Wanneer een AI-agent specifieke content moet extraheren, neem dan contentType en MIME-data op zodat je PDF’s, Excel-sheets of audio consequent kunt verwerken. Als je tekst uit PDF’s of audio moet extraheren, plan dan een extractiestap die het bestand converteert naar doorzoekbare tekst voordat je gaat samenvatten.

Permissiecontroles zijn noodzakelijk. Verifieer dat de verzoekende gebruiker leesrechten heeft voordat je een link genereert. Voor per-gebruiker toegang gebruik je de invite-API om expliciete toegang te verlenen in plaats van te vertrouwen op anonieme links. Links met organisatiebereik verminderen blootstelling, terwijl anonieme links extern delen vereenvoudigen maar de auditlast vergroten. Let op verweesde links van verplaatste of verwijderde items; implementeer regelmatige scans om gebroken links te detecteren en deze indien nodig te regenereren of in te trekken.

Hier is een checklist voor AI-query-matching:

1) Extraheer intentie en zoekwoorden. 2) Probeer eerst een ID-gebaseerde lookup (driveId + itemId). 3) Als geen ID, voer een padquery uit (/root:/path). 4) Als namen meerdere matches opleveren, filter op lastModifiedDateTime en owner. 5) Controleer sharing status en permissies. 6) Als er geen toegang is, biedt een workflow om toestemming aan te vragen.

Voorbeeld Graph padquery om een bestand te vinden op pad: GET /drives/{driveId}/root:/Reports/2025/Q1.pdf. Voorbeeldquery op id: GET /drives/{driveId}/items/{itemId}. Voor gedeelde drives en persoonlijke accounts verschillen de driveId-formaten. Ook, wanneer je individuele bestanden in logs of change-events moet refereren, sla stabiele itemId-waarden op zodat je AI altijd het juiste asset kan ophalen. Voor automatisering die met documenten en bestanden omgaat, voorkomen stabiele IDs veel randgevallen.

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

Het ontwerpen van een app die links ophaalt omvat een paar consistente componenten. Ten eerste, regel authenticatie. Gebruik OAuth 2.0 delegated flow voor apps met gebruikersinterface en client credentials voor achtergrondservices. Implementeer vervolgens een backend die Microsoft Graph aanroept. De backend moet permissies valideren, createLink aanroepen, resultaten cachen en acties loggen. Houd ook tokens veilig en roteer ze volgens best practices.

Architectuurschema van gebruikersapp en cloudinteracties

De AI-laag kan Azure OpenAI of andere modellen gebruiken om verzoeken te interpreteren en content samen te vatten. We raden aan Graph-lookup te combineren met een AI-samenvatter die korte abstracts en actiepunten produceert. Nadat de AI een samenvatting heeft gegenereerd, koppel je deze aan de link en geef je beide terug aan de gebruiker. Deze methode helpt gebruikers belangrijke bestanden snel te scannen zonder elk document te hoeven openen.

Integratiepunten omvatten Teams, Outlook, SharePoint en andere apps zoals CRM-systemen. Voeg bijvoorbeeld een knop in Outlook toe die de app activeert om een locatie te zoeken en een deelbare link bij te voegen. Voor logistieke teams lost het koppelen van de app aan e-mailagenten een veelvoorkomend probleem op: agenten moeten bestanden vinden en citeren terwijl ze antwoorden opstellen. Ons eigen platform geautomatiseerde logistieke correspondentie integreert meerdere bronnen en stelt contextuele antwoorden op, wat de verwerkingstijd voor repetitieve e-mails vermindert en teams helpt consistent te blijven.

Sequence diagram in words: User → app front end → app backend validates token → backend queries Microsoft Graph for the item → if needed backend calls createLink → backend stores link and metadata in cache → AI summariser fetches content → AI returns a summary → app presents link plus summary to user. This flow supports both synchronous responses and queued summaries for large PDFs or Excel workbooks.

Implementatietips: implementeer retry met exponentiële backoff voor tijdelijke Graph-fouten, geef de voorkeur aan v1.0-endpoints in productie, en vraag minimale scopes aan om blootstelling te verminderen. Bewaar logs voor auditing en om rollbacks mogelijk te maken. Voor veilige bestands toegang en om automatisering mogelijk te maken, ontwerp de app zodanig dat deze tenantbeleid respecteert en permission-issues als menselijke workflows presenteert zodat gebruikers toegang kunnen aanvragen. Bij het bouwen van integraties voor klantenservice of operations, vergeet niet contextuele citatie op te nemen en ondersteuning voor aanpassing zodat teams kunnen personaliseren hoe de app berichten opstelt en links beheert. Voor gedetailleerde voorbeelden van hoe AI de verwerkingstijd van e-mails in logistiek vermindert, zie onze logistieke AI-pagina’s die casestudy’s en ROI-metrics beschrijven hoe logistieke operaties zonder personeel op te schalen.

Implementatietips: implementeer retry met exponentiële backoff voor tijdelijke Graph-fouten, geef de voorkeur aan v1.0-endpoints in productie, en vraag minimale scopes aan om blootstelling te verminderen. Bewaar logs voor auditing en om rollbacks mogelijk te maken. Voor veilige bestands toegang en om automatisering mogelijk te maken, ontwerp de app zodanig dat deze tenantbeleid respecteert en permission-issues als menselijke workflows presenteert zodat gebruikers toegang kunnen aanvragen. Bij het bouwen van integraties voor klantenservice of operations, vergeet niet contextuele citatie op te nemen en ondersteuning voor aanpassing zodat teams kunnen personaliseren hoe de app berichten opstelt en links beheert. Voor meer voorbeelden van hoe AI e-mailverwerking voor logistiek automatiseert, zie geautomatiseerde logistieke correspondentie.

Implementatietips: implementeer retry met exponentiële backoff voor tijdelijke Graph-fouten, geef de voorkeur aan v1.0-endpoints in productie, en vraag minimale scopes aan om blootstelling te verminderen. Bewaar logs voor auditing en om rollbacks mogelijk te maken. Voor veilige bestands toegang en om automatisering mogelijk te maken, ontwerp de app zodanig dat deze tenantbeleid respecteert en permission-issues als menselijke workflows presenteert zodat gebruikers toegang kunnen aanvragen. Bij het bouwen van integraties voor klantenservice of operations, vergeet niet contextuele citatie op te nemen en ondersteuning voor aanpassing zodat teams kunnen personaliseren hoe de app berichten opstelt en links beheert. Voor gedetailleerde voorbeelden van hoe AI de verwerkingstijd van e-mails in logistiek vermindert, zie onze logistieke AI-pagina’s die casestudy’s en ROI-metrics beschrijven virtualworkforce.ai ROI logistiek.

Implementatiehints: implementeer retry met exponentiële backoff voor 429-responses, gebruik v1.0-endpoints in productie, vraag minimale scopes aan om blootstelling te beperken, en bewaar logs voor auditing en rollback. Ontwerp de app om tenantbeleid te respecteren en om permissieproblemen als menselijke workflows te tonen zodat gebruikers toegang kunnen aanvragen. Wanneer je integraties bouwt voor klantenservice of operations, zorg voor contextuele citatie en aanpassingsmogelijkheden zodat teams kunnen bepalen hoe de app berichten opstelt en links beheert. Voor gedetailleerde voorbeelden van hoe AI de verwerkingstijd van e-mails in logistiek vermindert, zie onze logistieke AI-pagina’s voor casestudy’s en ROI-gegevens beste AI-tools voor logistieke bedrijven.

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

Automatisering houdt links actueel en vermindert handmatige controles. Gebruik change notifications en webhooks om DriveItem-events te detecteren zoals verplaatsingen, hernoemingen, permissiewijzigingen en verwijderingen. Abonneren op DriveItem change notifications laat je app bijna realtime reageren. Gebruik daarnaast Graph delta queries voor efficiënte synchronisatie om te vinden wat er is veranderd sinds je laatste check. Delta-queries verminderen bandbreedte en zorgen dat je alleen gewijzigde onedrive-content verwerkt.

Ontwerpkeuzes: event-gedreven updates reageren snel, terwijl geplande scans een vangnet bieden. Combineer beide. Gebruik bijvoorbeeld webhooks om items als gewijzigd te markeren en voer een geplande taak uit om gecachte links eenmaal per dag te valideren. Wanneer je een verplaatst bestand of een verweesd item detecteert, valideer dan de gecachte link en regenereer deze alleen indien nodig. Implementeer ook een beleid om anonieme links ouder dan een drempel in te trekken en om links met organisatiebereik opnieuw uit te geven voor partners die doorlopende toegang moeten hebben.

Monitor en bestuur deelbare links. Audit createLink-activiteit regelmatig en markeer anonieme links. Gebruik tenantbeleid om het genereren van anonieme links te blokkeren waar compliance dit vereist. Implementeer alerting voor plotselinge pieken in externe shares. Voor rate limits behandel 429-responses met exponentiële backoff. Microsoft documenteert Graph-throttlinggedrag; behandel dit soepel en queue retries om te voorkomen dat je tijdens bulkbewerkingen limieten raakt. ServiceNow en andere platforms tonen patronen voor het integreren van notificaties en automatiseringen in IT-processen (bron).

Best practices checklist: pas least privilege toe, log alle deelgebeurtenissen, vereis gebruikersconsent voor apps met brede scope, scan regelmatig op anonieme links en geef waar mogelijk de voorkeur aan links met organisatiebereik. Voor operationele runbooks volg deze stappen: Detecteer via webhook → Valideer het item en permissies → Regenereer een link als de originele gebroken is → Informeer eigenaars en vraag goedkeuring als permissies zijn gewijzigd. Dit korte runbook helpt ops-teams om links nauwkeurig en veilig te houden.

Tenslotte, wees je bewust van compliance en gegevensverwerking in AI-pijplijnen. Wanneer je documentextracten naar modellen zoals die van OpenAI of Azure OpenAI stuurt, zorg dat je de juiste contractuele en technische waarborgen hebt. Microsoft’s privacyrichtlijnen vormen een basis voor connected experiences (bron). Voor teams die bestandretrieval en antwoorden in e-mail willen automatiseren, biedt het combineren van webhooks, delta-sync en AI-samenvatting een betrouwbaar patroon om bestandsbeheer te stroomlijnen en handmatig werk te verminderen. Als je een plug-and-play-oplossing zoekt die OneDrive en e-mail koppelt voor operations, onderzoek dan geïntegreerde oplossingen en connectors die zijn ontworpen voor logistieke en supportteams logistieke e-mail opstellen AI.

FAQ

How does OneDrive differ from SharePoint for storing files?

OneDrive is doorgaans bedoeld voor persoonlijke opslag en individuele bestanden, terwijl SharePoint bedoeld is voor teamsites en gedeelde mappenstructuren. Gebruik OneDrive voor concepten en persoonlijk werk, en gebruik SharePoint voor collaboratieve documenten en gedeelde bibliotheken.

What is the createLink action in the Microsoft Graph?

De createLink-actie is een Graph-endpoint dat een deelbare URL voor een DriveItem genereert. Het accepteert een type en scope, en de response bevat link.webUrl, link.type en link.scope. Als er een overeenkomende link bestaat, zal de API vaak de bestaande link retourneren.

Which permissions do I need to create sharing links?

Gedecentraliseerde apps hebben normaal Files.Read.All of Files.ReadWrite.All nodig wanneer ze namens een gebruiker handelen. App-only services gebruiken Sites.Read.All of Sites.ReadWrite.All. Pas altijd het principe van minste privilege toe en vraag tenantbeheerderstoestemming voor brede scopes.

How does AI locate files in OneDrive?

AI gebruikt NLP om gebruikersintentie te parseren en zoekt vervolgens Microsoft Graph naar overeenkomende DriveItems op ID, pad of metadata. Zodra een bestand is geïdentificeerd, controleert de AI permissies, roept createLink aan indien nodig, en kan een korte samenvatting produceren bij de link.

Can Copilot create links and summarise documents?

Ja, Microsoft 365 Copilot roept Microsoft Graph aan en kan een deelbare link maken en een document samenvatten. Copilot respecteert tenantbeleid en zal alleen content tonen waartoe de gebruiker toegang heeft. Controleer altijd privacyinstellingen voordat je gevoelige inhoud deelt.

What should I do about duplicate file names?

Gebruik driveId + itemId voor betrouwbare referenties, en gebruik metadatafilters zoals lastModifiedDateTime en owner om het juiste bestand te selecteren wanneer namen botsen. Stabiele IDs voorkomen verwarring wanneer bestanden worden verplaatst of hernoemd.

How do I keep cached links current?

Abonneer je op DriveItem change notifications en gebruik Graph delta queries om wijzigingen te detecteren. Wanneer er een wijziging optreedt, valideer de gecachte link, regenereer indien deze gebroken is, en informeer waar nodig eigenaars. Deze aanpak balanceert realtime-updates met geplande validatie.

Are anonymous links safe to use?

Anonieme links zijn handig maar vergroten het blootstellingsrisico. Geef de voorkeur aan links met organisatiebereik voor intern delen en gebruik anonieme links alleen voor kortdurend extern delen met strikte vervaltijden en audits. Scan regelmatig op anonieme links en trek ze in wanneer ze niet meer nodig zijn.

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

Implementeer exponentiële backoff voor 429-responses, queue retries en gebruik delta queries om het aantal verzoeken te verminderen. Bundel bewerkingen waar mogelijk en spreid zware synchronisaties over tijd om te voorkomen dat je throttlingdrempels raakt.

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

Ja. Converteer PDF’s of Excel-sheets eerst naar doorzoekbare tekst of gestructureerde data en voer vervolgens een AI-samenvatting uit over de geëxtraheerde content. Voor grote of complexe bestanden verwerk je in fasen en cache je de resultaten om herhaalde extractiewerkzaamheden te voorkomen.

Ready to revolutionize your workplace?

Achieve more with your existing team with Virtual Workforce.