API do OneDrive: arquivos, pastas e compartilhamento com agentes de IA
O acesso ao OneDrive por API é feito pelo Microsoft Graph, que permite listar, ler, enviar, buscar e compartilhar arquivos do OneDrive e do SharePoint. É usado por empresas no Microsoft 365 que querem automatizar documentos. O acesso é por app registrado no Microsoft Entra ID, com consentimento do administrador.
Os grandes recursos da API, em português claro.
Listar, ler, mover, renomear e excluir itens.
Enviar e baixar arquivos, inclusive grandes, em partes.
Procurar arquivos por nome e conteúdo.
Criar links e definir permissões de acesso.
Acompanhar o que mudou em uma pasta desde a última consulta.
Acessar bibliotecas de documentos de sites com a mesma lógica.
Como se acessa a API do OneDrive.
- Com credencial da sua empresaOAuth 2.0 com app registrado no Microsoft Entra ID e permissões do Graph para arquivos; permissões de aplicativo exigem consentimento do administrador.
- Documentação oficiallearn.microsoft.com/onedrive/developer
- Permissões de aplicativo dão acesso amplo: restrinja ao mínimo.
- Há limites de requisição no Microsoft Graph.
- Cuidado com links de compartilhamento externo.
- api onedrive
- onedrive api
- microsoft graph onedrive
- onedrive api upload
- integração onedrive
- api onedrive sharepoint
O que um agente do iTeam faz com a API do OneDrive.
O agente salva anexos de e-mail na pasta certa do cliente, com nome padronizado.
O colaborador pergunta no Teams e o agente acha o contrato ou a proposta certa.
O agente lista links públicos antigos e pede aprovação para revogar.
O agente junta documentos de um processo em uma pasta e compartilha com o auditor após aprovação.
Da credencial ao agente trabalhando, com aprovação.
Registrar o app no Entra ID
Crie o registro e conceda só as permissões de arquivos necessárias, de preferência limitadas a sites e pastas.
Cofre do iTeam
Guarde o segredo ou certificado no cofre e defina por agente as pastas e ações permitidas.
Aprovação para compartilhar
Compartilhamentos externos e exclusões exigem aprovação humana, com auditoria.
Dúvidas sobre a API do OneDrive.
A API do OneDrive é gratuita?
De forma geral, o Microsoft Graph não cobra pelas chamadas comuns de arquivos; o armazenamento segue a licença do Microsoft 365.
Preciso programar para usar a API do OneDrive com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação da API e aprende os endpoints, e o time de implantação configura credenciais, permissões e testes com você.
A API do OneDrive é o Microsoft Graph?
Sim. O acesso atual ao OneDrive e ao SharePoint por API é feito pelo Microsoft Graph.
Como um agente acessa arquivos do OneDrive pelo Microsoft Graph?
O OneDrive é acessado pelo Microsoft Graph, com recursos como Drive e DriveItem e caminhos como /me/drive ou /sites/{id}/drive para o SharePoint. O agente lista pastas, baixa e envia arquivos e busca por nome. Para isso, o aplicativo é registrado no Microsoft Entra ID e recebe permissões de arquivos do Graph, com consentimento do administrador quando forem permissões de aplicativo.
Permissão delegada ou de aplicativo no OneDrive: qual escolher?
A permissão delegada age em nome de um usuário conectado e só enxerga o que ele enxerga, enquanto a de aplicativo age sem usuário e exige consentimento do administrador, com alcance amplo. Para um agente que atende um setor, prefira a delegada ou restrinja a de aplicativo ao mínimo. Confira na documentação do Graph os escopos de arquivos mais estreitos disponíveis.
Dá para testar a API do OneDrive sem mexer nos arquivos da empresa?
A documentação do Graph não descreve um sandbox do OneDrive, então confira na documentação oficial da Microsoft se há tenant de desenvolvedor para o seu caso. Sem ele, crie uma pasta de teste com arquivos fictícios, registre o aplicativo com permissão só para essa pasta e apenas depois aponte para as pastas de verdade.
O que o agente pode fazer com documentos no OneDrive e no SharePoint?
Como a API cobre arquivos, pastas, upload, download, busca, compartilhamento e mudanças, o agente busca contratos por nome, guarda relatórios gerados em uma pasta e avisa quando algo muda. O SharePoint entra pelo mesmo Graph, nas bibliotecas de documentos de um site. No iTeam, o agente propõe e quem tem a alçada aprova antes de apagar ou compartilhar.
Compartilhar link do OneDrive por agente é seguro?
Criar link de compartilhamento é recurso da API, e um link aberto a qualquer pessoa vaza o documento se for parar no destino errado. Por isso a lista de cuidados alerta para links externos. Limite o agente a links para pessoas específicas da organização, bloqueie links anônimos e exija aprovação humana para qualquer compartilhamento fora do domínio.
O Microsoft Graph tem limite de requisições que afeta o OneDrive?
Sim, o Graph aplica limitação de requisições e, ao exceder, pede que o cliente espere antes de tentar de novo. Não cito números porque variam, então confira na documentação de limites do Graph. Na prática, o agente deve respeitar o tempo de espera indicado, evitar varrer pastas inteiras toda hora e usar o recurso de mudanças para ver só o que foi alterado.
A empresa precisa de Microsoft 365 para usar a API do OneDrive com agente?
O acesso corporativo descrito aqui pressupõe contas Microsoft 365 com Entra ID, onde um administrador registra o aplicativo e dá o consentimento. Quem usa só OneDrive pessoal segue outro caminho de registro, então confira na documentação da Microsoft qual vale no seu caso. Sem acesso de administrador a configuração trava, e o diagnóstico do iTeam verifica esses acessos antes do projeto.
Um agente organizando pastas do OneDrive esbarra na LGPD?
Pastas de RH, contratos e financeiro guardam dados pessoais, então o agente deve enxergar só o necessário e ter cada mover ou apagar registrado. Arquivos pessoais de funcionários não deveriam entrar no escopo. A LGPD pede finalidade e minimização; valide a política com o responsável de dados. A trilha do iTeam registra quem pediu e o que o agente fez.
