API do OneDrive: IA para obter links no OneDrive

Novembro 7, 2025

Data Integration & Systems

onedrive e microsoft — abrangência, estatísticas e segurança

OneDrive está no centro do armazenamento moderno de arquivos para muitas empresas e indivíduos. A Microsoft posiciona o OneDrive como um repositório em nuvem que liga armazenamento pessoal a hubs empresariais. Para ficar claro, o OneDrive serve contas pessoais enquanto o SharePoint lida com sites de equipa e estruturas de pastas partilhadas. Essa divisão é importante ao escolher onde armazenar ficheiros importantes e ao conceber políticas de acesso.

Em larga escala, o OneDrive suporta uma grande base de utilizadores. Por exemplo, foi relatado que o OneDrive atinge mais de 500 milhões de utilizadores ativos em todo o mundo, o que mostra a escala do ambiente que uma aplicação ou automatização tem de suportar (fonte). Além disso, o OneDrive regista volumes diários muito elevados de conteúdo; relatórios indicam mais de um bilião de ficheiros carregados diariamente, o que sublinha porque qualquer sistema que obtenha links deve funcionar de forma rápida e fiável (fonte). Para empresas, OneDrive e SharePoint desempenham papéis diferentes mas complementares: o OneDrive armazena ficheiros individuais e trabalho pessoal, enquanto o SharePoint armazena ficheiros de equipa e conteúdo partilhado.

A segurança e conformidade regem como os links funcionam. A Microsoft encripta dados em repouso e em trânsito, e aplica autenticação multifator e DLP para controlo do tenant. A Microsoft declara explicitamente que as experiências conectadas seguem regras estritas de privacidade, e que apenas os dados necessários saem de um tenant para funções de IA (fonte). Os tenants devem equilibrar conveniência e exposição. Por exemplo, links anónimos reduzem atritos mas aumentam o risco. Prefira links com âmbito organizacional quando precisar restringir o acesso, e use links anónimos apenas para ativos verdadeiramente públicos.

Os administradores podem auditar a atividade de partilha. Ferramentas como o Microsoft Graph Data Connect e os registos de auditoria permitem consultar o conjunto de dados de partilha e rastrear quem criou links. Use essas ferramentas para sinalizar links anónimos e impor retenção. Para orientação ao nível do ambiente e integrações, o ServiceNow e outras plataformas documentam conectores do OneDrive que ligam eventos de volta a processos de TI (fonte). Esse nível de integração ajuda as equipas de operações a reduzir verificações manuais e a manter a conformidade.

Pontos práticos: se quiser armazenar os seus ficheiros para colaboração interna, escolha links com âmbito organizacional. Se precisar partilhar com contratantes externos por um curto período, utilize links anónimos com prazo limitado e audite-os. Finalmente, quando arquitetar soluções para equipas, lembre-se que o OneDrive é a opção principal para trabalho pessoal e o SharePoint é o hub para colaboração de equipa. Para equipas de operações que respondem a muitos e-mails e precisam de acesso rápido a ficheiros, integrar o OneDrive com agentes de e-mail pode reduzir dramaticamente o tempo de tratamento; veja como a virtualworkforce.ai acelera respostas ao fundamentar respostas em fontes como SharePoint e OneDrive assistente virtual para logística.

microsoft onedrive api — createLink, permissions and response

A API Microsoft OneDrive expõe ações que se usam para criar links de partilha. O endpoint central para criação de links é a ação createLink. Use o padrão POST para criar ou devolver um link existente: POST https://graph.microsoft.com/v1.0/drives/{driveId}/items/{itemId}/createLink. O corpo da solicitação aceita JSON simples como { “type”:”view”, “scope”:”organization” } ou { “type”:”edit”, “scope”:”anonymous” } para gerar links de visualização ou edição. Para ativos incorporáveis, use o tipo “embed”.

Respostas típicas incluem link.webUrl, link.type e link.scope. Note que a API devolve um link existente se já existir uma correspondência, o que evita URLs anónimas duplicadas. Sistemas de produção devem portanto verificar os carimbos de data/hora na resposta e reutilizar links quando apropriado. Para a referência oficial do createLink e o formato JSON exato, consulte a documentação do Microsoft Graph para driveItem createLink (a documentação oficial fornece exemplos completos e notas sobre scopes).

Diagrama de fluxo de solicitação da API

As permissões importam. Use scopes com o mínimo privilégio necessário. Tokens delegados tipicamente necessitam de Files.Read.All ou Files.ReadWrite.All quando atuam em nome de um utilizador. Para cenários de serviço apenas-app, use os scopes equivalentes de app como Sites.Read.All ou Sites.ReadWrite.All e garanta que os administradores do tenant consentem antes de um acesso alargado. Além disso, prefira endpoints v1.0 para produção. O caminho /beta pode oferecer funcionalidades extra mas muda frequentemente e pode não ser estável para serviços de longo prazo.

Aqui está um exemplo compacto do corpo da solicitação para gerar um link de visualização com âmbito organizacional:

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

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

Quando desenhar uma app que chama createLink, valide permissões antes de efetuar a chamada. Depois verifique link.scope e link.webUrl na resposta. Se um utilizador não tiver permissão para ver um ficheiro, a sua app deve pedir consentimento ou devolver um erro útil ao utilizador para que este possa solicitar acesso.

Checklist de segurança: exigir consentimento do tenant para permissões de app de amplo alcance; implementar um trilho de auditoria para chamadas createLink; evitar gerar links anónimos por padrão; e implementar expiries curtos para links externos. Para mais sobre permissões e padrões de uso, veja a orientação técnica da Microsoft e a referência de permissões do Graph. Para cenários reais de localizar-e-gerar, a Netwoven documenta como as ferramentas de localização de ficheiros mapeiam para itens do SharePoint e OneDrive, o que é útil quando quer que a app recupere conteúdo existente de forma fiável (fonte). Finalmente, tenha em mente que o Graph pode devolver links existentes, por isso desenhe a sua lógica de cache e atualização de links em conformidade.

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

A IA agora ajuda a encontrar itens e a gerar contexto. Modelos de IA fazem parsing de consultas naturais e mapeiam-nas para identificadores de ficheiros, metadados ou caminhos. O fluxo começa com deteção de intenção: o NLP extrai nomes de ficheiros, datas ou conceitos como “relatório do último trimestre”. A IA depois consulta o Microsoft Graph para encontrar DriveItems correspondentes e validar permissões. Em seguida, o sistema ou reutiliza um link existente ou chama createLink para gerar uma nova URL de partilha.

O Microsoft 365 Copilot e outros agentes seguem este padrão. O Copilot chama o Microsoft Graph, respeita as políticas do tenant, e pode produzir um pequeno resumo de IA que acompanha um link. Por exemplo, pode pedir ao Copilot para “Create a shareable summary link for last quarter’s report” e o Copilot localizará o documento, confirmará o acesso, gerará um link e depois resumirá os pontos-chave. A Microsoft declarou que as experiências conectadas só enviam o necessário e que cumprem as regras de privacidade do tenant (fonte). Isto ajuda quando precisa garantir que nenhum dado em excesso sai do tenant.

Caso de uso prático: recebe um e-mail a pedir números de vendas. O seu agente de IA interpreta o pedido, pesquisa no OneDrive por documentos com títulos correspondentes, verifica que o solicitante tem direitos, cria ou devolve um link de visualização e depois resume os números principais. Isto melhora a rapidez de resposta e reduz erros. Para equipas que lidam com muitos e-mails recebidos, essa automatização liga-se diretamente a ganhos de produtividade; os nossos clientes vêem reduções acentuadas no tempo de tratamento quando a IA utiliza documentos autorizados e elabora respostas fundamentadas nesses ficheiros como melhorar o atendimento ao cliente na logística com IA.

Persistem limitações. A IA tem dificuldades com consultas ambíguas, nomes de ficheiros duplicados e lacunas de permissões. Se vários ficheiros corresponderem a uma consulta, a IA deve apresentar opções em vez de adivinhar. Além disso, se o utilizador não tiver acesso, a IA não pode forçar permissão; deve solicitar aprovação. Finalmente, tenha atenção às regras de tratamento de dados ao usar serviços de IA externos como OpenAI ou Azure OpenAI; assegure que configura restrições ao nível do tenant e verifique que os resumos não divulgam secções sensíveis dos documentos. Para funcionalidades de IA futuras e atualizações de plataforma, o blog da Microsoft destaca trabalho para melhorar a gestão de conteúdos no SharePoint e OneDrive em atualizações futuras (fonte). Use esses sinais ao planear melhorias que integrem o Copilot ou serviços baseados em GPT.

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

A obtenção precisa depende de identificadores estáveis e metadados ricos. O identificador mais fiável é a combinação driveId e itemId. Também pode usar endereçamento baseado em caminho com /root:/path/to/file se preferir consultas legíveis por humanos. No entanto, caminhos partem quando ficheiros se movem ou quando pastas são renomeadas. Por estas razões, prefira IDs estáveis para buscas programáticas. Use a expressão onedrive files ao descrever APIs que retornam coleções de itens num drive.

Campos de metadados úteis incluem name, lastModifiedDateTime, owner, size, file hashes e sharing status. Estes campos ajudam a desambiguar resultados. Por exemplo, verifique lastModifiedDateTime e owner para selecionar a versão mais recente quando existirem nomes duplicados. Além disso, hashes de ficheiros ou ETags detectam alterações para que possa atualizar resumos apenas quando o conteúdo realmente mudar. Quando um agente de IA tiver de extrair conteúdo específico, inclua contentType e dados MIME para que consiga lidar consistentemente com PDFs, folhas Excel ou áudio. Se precisar extrair texto de PDFs ou áudio, planeie uma etapa de extração que converta o ativo em texto pesquisável antes da sumarização.

Verificações de permissões são necessárias. Confirme que o utilizador solicitante tem acesso de leitura antes de gerar um link. Para acessos por utilizador, use a API invite para conceder acesso explícito em vez de confiar em links anónimos. Links com âmbito organizacional reduzem a exposição, enquanto links anónimos simplificam a partilha externa mas aumentam a carga de auditoria. Fique atento a links órfãos de itens movidos ou eliminados; implemente varreduras regulares para detetar links quebrados e para os regenerar ou revogar conforme necessário.

Aqui está um checklist para correspondência de consultas por IA:

1) Extrair a intenção e palavras-chave de pesquisa. 2) Tentar primeiro a pesquisa por ID (driveId + itemId). 3) Se não houver ID, executar uma consulta por caminho (/root:/path). 4) Se nomes retornarem múltiplas correspondências, filtrar por lastModifiedDateTime e owner. 5) Verificar o estado de partilha e permissões. 6) Se não houver acesso, fornecer um fluxo de trabalho para solicitar permissão.

Exemplo de consulta de caminho no Graph para encontrar um ficheiro por caminho: GET /drives/{driveId}/root:/Reports/2025/Q1.pdf. Consulta por id: GET /drives/{driveId}/items/{itemId}. Para unidades partilhadas e contas pessoais, lembre-se que os formatos de driveId diferem. Além disso, quando precisar referenciar ficheiros individuais em registos ou eventos de alteração, armazene valores de itemId estáveis para que a sua IA possa sempre buscar o ativo correto. Para automatizações que interajam com documentos e ficheiros, IDs estáveis previnem muitos casos limite.

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

Conceber uma app que recupera links envolve alguns componentes consistentes. Primeiro, trate da autenticação. Use o fluxo delegado OAuth 2.0 para aplicações orientadas ao utilizador e credenciais de cliente para serviços em segundo plano. A seguir, implemente um backend que chame o Microsoft Graph. O backend deve validar permissões, chamar createLink, colocar em cache os resultados e registar ações. Além disso, mantenha tokens seguros e rode-os conforme as boas práticas.

Esquema de arquitetura das interações entre aplicação do utilizador e nuvem

A camada de IA pode usar Azure OpenAI ou outros modelos para interpretar pedidos e sumarizar conteúdo. Recomendamos combinar a pesquisa no Graph com um sumarizador de IA que produza abstracts curtos e pontos de ação. Depois da IA gerar um resumo, anexe‑o ao link e devolva ambos ao utilizador. Este método ajuda os utilizadores a verificar rapidamente ficheiros importantes sem abrir cada documento.

Pontos de integração incluem Teams, Outlook, SharePoint e outras apps como sistemas CRM. Por exemplo, adicione um botão no Outlook que dispare a app para localizar e anexar um link de partilha. Para equipas de logística, ligar a app a agentes de e-mail resolve um problema comum: os agentes precisam encontrar e citar ficheiros enquanto redigem respostas. A nossa própria plataforma virtualworkforce.ai integra múltiplas fontes e elabora respostas contextuais, o que reduz o tempo de tratamento para e-mails repetitivos e ajuda as equipas a manterem-se consistentes correspondência logística automatizada.

Diagrama de sequência em palavras: Utilizador → frontend da app → backend da app valida token → backend consulta o Microsoft Graph pelo item → se necessário o backend chama createLink → backend armazena link e metadados em cache → sumarizador de IA busca conteúdo → IA devolve um resumo → app apresenta link mais resumo ao utilizador. Este fluxo suporta respostas síncronas e resumos enfileirados para PDFs ou folhas Excel grandes.

Dicas de implementação: implemente retry com backoff exponencial para erros transitórios do Graph, prefira endpoints v1.0 em produção, e solicite scopes mínimos para reduzir exposição. Armazene registos para auditoria e para permitir rollbacks. Para acesso seguro a ficheiros e para permitir automatização, desenhe a app para respeitar políticas do tenant e para expor problemas de permissão como fluxos humanos para que os utilizadores possam solicitar acesso. Ao construir integrações para atendimento ao cliente ou operações, lembre-se de incluir citação contextual e suportar personalização para que as equipas possam personalizar como a app redige mensagens e gere links. Para exemplos detalhados de como a IA reduz o tempo de tratamento de e-mails na logística, veja as nossas páginas de IA na logística que descrevem estudos de caso e métricas de ROI como escalar operações logísticas sem contratar.

Implementação: implemente retry com backoff exponencial para erros transitórios do Graph, prefira endpoints v1.0 em produção e solicite scopes mínimos para reduzir exposição. Armazene logs para auditoria e para permitir rollbacks. Para acesso seguro a ficheiros e para permitir automatização, desenhe a app para respeitar políticas do tenant e para expor problemas de permissão como fluxos humanos para que os utilizadores possam solicitar acesso. Ao construir integrações para atendimento ao cliente ou operações, lembre-se de incluir citação contextual e suportar personalização para que as equipas possam personalizar como a app redige mensagens e gere links. Para exemplos detalhados de como a IA reduz o tempo de tratamento de e-mails na logística, veja as nossas páginas de IA na logística que descrevem estudos de caso e métricas de ROI como escalar operações logísticas sem contratar.

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

A automatização mantém os links atualizados e reduz verificações manuais. Use notificações de alteração e webhooks para detetar eventos de DriveItem como movimentos, renomeações, alterações de permissão e eliminações. Subscrever notificações de alteração de DriveItem permite que a sua app reaja quase em tempo real. Entretanto, use queries delta do Graph para sincronização eficiente e para encontrar o que mudou desde a sua última verificação. Queries delta reduzem largura de banda e garantem que só processa conteúdo do onedrive modificado.

Escolhas de desenho: atualizações orientadas por eventos reagem rapidamente, enquanto varreduras programadas fornecem uma rede de segurança. Combine ambos. Por exemplo, use webhooks para marcar itens como alterados e execute um trabalho agendado para validar links em cache uma vez por dia. Quando detetar um ficheiro movido ou um item órfão, valide o link em cache e regenere‑o apenas se necessário. Além disso, implemente uma política para revogar links anónimos mais antigos que um limiar e para reemitir links com âmbito organizacional para parceiros que precisam de manter acesso contínuo.

Monitore e governe links de partilha. Audite regularmente a atividade createLink e sinalize links anónimos. Use políticas do tenant para bloquear a geração de links anónimos quando a conformidade o exigir. Implemente alertas para picos repentinos em partilhas externas. Para limites de taxa, trate respostas 429 com backoff exponencial. A Microsoft documenta o comportamento de throttling do Graph; trate‑o de forma graciosa e enfileire tentativas para evitar atingir limites durante operações em massa. O ServiceNow e outras plataformas mostram padrões para integrar notificações e automatizações em processos de TI (fonte).

Checklist de melhores práticas: aplicar o princípio do menor privilégio, registar todos os eventos de partilha, exigir consentimento de utilizador para apps de amplo escopo, verificar regularmente links anónimos e preferir links com âmbito organizacional quando possível. Para runbooks operacionais, siga estes passos: Detetar via webhook → Validar o item e permissões → Regenerar um link se o original estiver quebrado → Notificar proprietários e pedir aprovação se as permissões mudaram. Este runbook curto ajuda as equipas de operações a manter links precisos e seguros.

Finalmente, tenha em atenção a conformidade e o tratamento de dados em pipelines de IA. Quando enviar extratos de documentos para modelos como os da OpenAI ou Azure OpenAI, assegure que tem as salvaguardas contratuais e técnicas adequadas. A orientação de privacidade da Microsoft é uma linha de base para experiências conectadas (fonte). Para equipas que queiram automatizar recuperação de ficheiros e respostas dentro de e-mail, combinar webhooks, sincronização delta e sumarização por IA fornece um padrão fiável para simplificar a gestão de ficheiros e reduzir trabalho manual. Se precisar de uma abordagem plug‑and‑play que ligue OneDrive e e-mail para operações, explore soluções integradas e conectores desenhados para equipas de logística e suporte IA para redação de e-mails logísticos.

FAQ

How does OneDrive differ from SharePoint for storing files?

O OneDrive normalmente serve para armazenamento pessoal e ficheiros individuais, enquanto o SharePoint é para sites de equipa e estruturas de pastas partilhadas. Use o OneDrive para rascunhos e trabalho pessoal, e use o SharePoint para documentos colaborativos e bibliotecas partilhadas.

What is the createLink action in the Microsoft Graph?

A ação createLink é um endpoint do Graph que gera uma URL partilhável para um DriveItem. Aceita um type e um scope, e a resposta contém link.webUrl, link.type e link.scope. Se já existir um link correspondente, a API frequentemente irá devolver o link existente.

Which permissions do I need to create sharing links?

Aplicações delegadas normalmente precisam de Files.Read.All ou Files.ReadWrite.All quando atuam como um utilizador. Serviços apenas-app usam Sites.Read.All ou Sites.ReadWrite.All. Aplique sempre o princípio do menor privilégio e peça consentimento de administrador do tenant para scopes mais abrangentes.

How does AI locate files in OneDrive?

A IA usa NLP para analisar a intenção do utilizador e depois consulta o Microsoft Graph por DriveItems correspondentes por ID, caminho ou metadados. Uma vez identificado o ficheiro, a IA verifica permissões, chama createLink se necessário, e pode produzir um pequeno resumo para acompanhar o link.

Can Copilot create links and summarise documents?

Sim, o Microsoft 365 Copilot chama o Microsoft Graph e pode criar um link partilhável e produzir um resumo. O Copilot respeita as políticas do tenant e só irá mostrar conteúdo que o utilizador pode aceder. Verifique sempre as definições de privacidade antes de partilhar conteúdo sensível.

What should I do about duplicate file names?

Use driveId + itemId para referências fiáveis, e utilize filtros de metadados como lastModifiedDateTime e owner para selecionar o ficheiro correto quando os nomes colidirem. IDs estáveis evitam ambiguidade quando ficheiros se movem ou são renomeados.

How do I keep cached links current?

Subscreva notificações de alteração de DriveItem e use queries delta do Graph para detetar mudanças. Quando ocorrer uma alteração, valide o link em cache, regenere se estiver quebrado, e notifique os proprietários quando necessário. Esta abordagem equilibra atualizações em tempo real com validação agendada.

Are anonymous links safe to use?

Links anónimos são convenientes mas aumentam o risco de exposição. Prefira links com âmbito organizacional para partilha interna e use links anónimos apenas para partilha externa de curto prazo com expiries rigorosos e auditorias. Verifique regularmente a existência de links anónimos e revogue‑os se já não forem necessários.

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

Implemente backoff exponencial para respostas 429, enfileire tentativas e use queries delta para reduzir o número de pedidos. Além disso, realize operações em lote quando possível e distribua sincronizações pesadas ao longo do tempo para evitar atingir limites de throttling.

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

Sim. Converta PDFs ou folhas Excel em texto pesquisável ou em dados estruturados primeiro, e depois execute um sumarizador de IA sobre o conteúdo extraído. Para ficheiros grandes ou complexos, processe em etapas e coloque em cache os resultados para evitar trabalho repetido de extração.

Ready to revolutionize your workplace?

Achieve more with your existing team with Virtual Workforce.