Introdução à API do OneDrive

  • Artigo

Esta página fornece uma rápida visão geral das etapas necessárias para usar a API do OneDrive e o Microsoft Graph. Para saber mais, consulte o Início rápido do Microsoft Graph.

Se você estiver trabalhando com o SharePoint Server 2016, ou não estiver usando o Microsoft Graph, consulte o tópico Usar a API do OneDrive com o SharePoint Server 2016.

1. Autenticação de usuário e autorização de seu aplicativo

O Microsoft Graph e a API do OneDrive usam OAuth 2.0 para autorização. Ao concluir um fluxo do OAuth, seu aplicativo recebe um token de acesso que oferece acesso ao Microsoft Graph para um conjunto específicos de permissões para um usuário.

O aplicativo fornece o token de acesso em cada solicitação, por meio de um cabeçalho HTTP:

Authorization: bearer {token}

Para saber mais sobre como autorizar seu aplicativo e obter um token de acesso, veja Autorização de aplicativo com o Microsoft Graph.

2. Fazer chamadas para um recurso

Após a autorização de seu aplicativo e o recebimento de um token de acesso, ele poderá fazer solicitações para o ponto de extremidade do Microsoft Graph por recursos do OneDrive ou do SharePoint. Para construir a URL para um recurso, você precisa saber a URL relativa ao recurso raiz (como um usuário, grupo ou site) e recurso drive ou recurso driveItem ao qual sua solicitação está direcionando.

Uma URL de solicitação inclui estes componentes:

  • URL raiz e versão do Microsoft Graph (https://graph.microsoft.com/v1.0)
  • Um destino de recurso raiz (/users/{id})
  • Um destino de recurso da API do OneDrive (/drive, /drives/{id}/items/{item-id} ou /drive/root:/path/to/item)

Observação: Em toda a documentação, somente a sintaxe parcial, como: GET /drive/items/{item-id} é usada para brevidade. Prefixe o caminho com a URL raiz correta e o direcionamento de recurso raiz a fim de obter a URL ou o caminho completo do recurso.

3. Continue

Confira as Amostras do OneDrive no GitHub e as Amostras do Microsoft Graph no GitHub para saber mais sobre como usar arquivos no Microsoft Graph.

Leia a documentação de HTTP da API do OneDrive para saber mais sobre como trabalhar com os recursos drive e driveItem. Para saber mais sobre todos os recursos no Microsoft Graph, veja a documentação do Microsoft Graph.

Tem dúvidas ou precisa de suporte? Encontre-nos na Stack Overflow e na página de problemas do GitHub para conferir nossa documentação.