Visão geral do Microsoft Graph

O Microsoft Graph expõe várias APIs do Office 365 e outros serviços de nuvem da Microsoft por meio de um único ponto de extremidade: (https://graph.microsoft.com). O Microsoft Graph simplifica as consultas que, de outra forma, seriam mais complexas.

Você pode usar a instalação do Microsoft Graph para:

  • Acessar os dados de vários serviços de nuvem da Microsoft, como Azure Active Directory, Exchange Online como parte do Office 365, SharePoint, OneDrive, OneNote e Planner.
  • Navegar entre entidades e relações.
  • Acessar a inteligência e as informações provenientes da nuvem da Microsoft (para usuários comerciais).

Pilha de desenvolvimento do Microsoft Graph

Um diagrama que mostra as camadas da pilha de desenvolvimento do Microsoft Graph. Na parte inferior, está a camada de dados, que inclui usuários, grupos, arquivos, emails, calendários, contatos pessoais, tarefas, contatos da organização, pessoas, Excel e anotações. A próxima camada é autenticação e autorização A próxima é o ambiente de desenvolvimento da sua escolha, como os SDKs da API do Microsoft Graph do Visual Studio, iOS e Android. A camada final é a sua solução, que usa a tecnologia da sua escolha, como .NET, JS, HTML e Ruby, e está hospedada no Microsoft Azure ou em outra plataforma de hospedagem.

Consultas comuns do Microsoft Graph

O Microsoft Graph expõe dois pontos de extremidade: /v1.0 e /beta. O ponto de extremidade /v1.0 inclui os recursos que você pode acessar em seu aplicativo de produção. O ponto de extremidade /beta inclui APIs que estão atualmente em modo de visualização. A tabela a seguir lista algumas consultas comuns que você pode usar para acessar a API do Microsoft Graph.

Operação Ponto de extremidade de serviço
GET meu perfil https://graph.microsoft.com/v1.0/me
GET meus arquivos https://graph.microsoft.com/v1.0/me/drive/root/children
GET minha foto https://graph.microsoft.com/v1.0/me/photo/$value
GET meu email https://graph.microsoft.com/v1.0/me/messages
GET meu email de alta prioridade https://graph.microsoft.com/v1.0/me/messages?$filter=importance%20eq%20'high'
GET meu calendário https://graph.microsoft.com/v1.0/me/calendar
GET meu gerente https://graph.microsoft.com/v1.0/me/manager
GET o último usuário que modificou o arquivo foo.txt https://graph.microsoft.com/v1.0/me/drive/root/children/foo.txt/lastModifiedByUser
GET grupos unificados dos quais sou membro https://graph.microsoft.com/v1.0/me/memberOf/$/microsoft.graph.group?$filter=groupTypes/any(a:a%20eq%20'unified')
GET os usuários em minha organização https://graph.microsoft.com/v1.0/users
GET conversas em grupo https://graph.microsoft.com/v1.0/groups/{id}/conversations
GET as pessoas relacionadas a mim https://graph.microsoft.com/beta/me/people
Itens GET mais populares à minha volta https://graph.microsoft.com/beta/me/insights/trending
GET minhas tarefas https://graph.microsoft.com/beta/me/tasks
GET minhas anotações https://graph.microsoft.com/beta/me/notes/notebooks

Observação: As APIs no ponto de extremidade beta estão sujeitas a mudanças. Não recomendamos que você as use em seus aplicativos de produção.

Explorar o Microsoft Graph

Seus comentários são importantes para nós. Junte-se a nós na página Stack Overflow. Marque as suas perguntas com {MicrosoftGraph} e {office365}.