A Microsoft vem expandindo os serviços e disponibilizando em sua API unificada. Então significa que as APIs que estão separadas e deixaram de funcionar? Não, serão migradas para o Microsoft Graph, assim como ocorreu com o Office Graph.
E essa única API vai disponibilizar que tipo de interação?
Acesso a dados – É possível acessar meus dados, perfil, grupos ou até consultar algumas mensagens de e-mails, através de chamadas como /me, /groups, /messages e assim por diante. Reforço que se fosse somente realizar acesso a dados isso seria mais uma API, mas isso não é tudo.
Dados Transversais – Essa é uma das interações que contribui para diferenciar o Microsoft Graph de uma simples API de consulta. Os dados tem uma ligação entre diversas outras informações – isso faz parte da Teoria dos Grafos. Em resumo é o fato de conseguir atravessar informações sobre as ligações entre os nós de informações conectadas. Como por exemplo, uma url /drive/items/<id>/lastModifyByUser, ou seja, é possível acessar um item no drive que retornará informações do usuário que realizou a última modificação em um determinado arquivo.
Teoria dos Grafos:
A Teoria dos Grafos é um ramo da matemática que estuda as relações entre os objetos de um determinado conjunto. Para tal são empregadas estruturas chamadas de grafos, G(V,E), onde V é um conjunto não vazio de objetos denominados vértices e E é um subconjunto de pares não ordenados de V, chamados arestas.
Dependendo da aplicação, arestas podem ou não ter direção, pode ser permitido ou não arestas ligarem um vértice a ele próprio e vértices e/ou arestas podem ter um peso (numérico) associado. Se as arestas têm uma direção associada temos um dígrafo (grafo orientado). Um grafo com um único vértice e sem arestas é conhecido como grafo trivial.
Estruturas que podem ser representadas por grafos estão em toda parte e muitos problemas de interesse prático podem ser formulados como questões sobre certos grafos. Por exemplo, a estrutura de ligações da Wikipédia pode ser representada por um dígrafo: os vértices são os artigos da Wikipédia e existe uma aresta do artigo A para o artigo B se e somente se A contém um link para B. Dígrafos são também usados para representar máquinas de estado finito. O desenvolvimento de algoritmos para manipular grafos é um tema importante da ciência da computação.
Acessando dados Inteligentes – A Microsoft também vem criando mecanismos de aprendizagem de máquina. Isso, irá permitir que as informações tenham bases em diversas esferas, sem a necessidade de acessar um caminho especifico, como por exemplo: Quando for necessário trazer todos os documentos que são tendências entre todos os usuários que compartilho informações. Para uma simples API de consulta, neste caso, é necessário realizar a consulta de cada documento e realizar uma lógica por trás disso. Porém o Microsoft Graph faz esse trabalho da lógica, com o conceito de acesso a dados inteligentes, disponibilizando um único caminho pode então realizar essa busca, /insigths/trends. Para quem tem o Office 365 na empresa e acessa o Delve, é uma plataforma que pode ser um ótimo exemplo da utilização de dados inteligentes através do Microsoft Graph.
Quando se fala de acesso a partir de um ponto de acesso ao usuário, é necessário realizar o login através de uma das contas da Microsoft, seja do tipo Work/School ou Microsoft Accounts. Porém, isso dificultava um pouco a consulta de informações em uma dessas contas, pois eram cenários de informações bem diferentes, ou seja, várias APIs para acessar dados e isso trazia uma certa confusão.
Do ponto de vista comercial, gerará menos custos de desenvolvimento e agregará mais valores para as entregas que tiverem suas integrações partindo de um único ponto.
Abaixo, seguem alguns endpoints necessários para realizar a anterior integração.
Há uma fácil unificação, para ler meu serviço o caminho seria https://graph.microsoft.com/v1.0/me. Perceba que há o caminho da versão? Isso é muito bom, porque podemos mudar de uma versão para outra e até mesmo testá-las.
Abaixo nós temos uma tabela com alguns dos serviços que já estão disponíveis na versão 1.0 e uns da versão beta. Visite o site do Microsoft Graph na parte de documentação e lá verá essa lista de serviços.
Então como começar os estudos sem a necessidade de utilizar o Graph Explorer disponível no site?
Bem, comece primeiramente entendendo a questão da autorização, ou seja, o que de fato, é necessário para que a minha aplicação possa acessar os dados a partir de um ponto de autenticação. Ótimo, falamos na palavra autenticação e autorização, isso soa ao OAuth 2.0 Flow – não precisamos entrar em muitos detalhes sobre esse fluxo, pois já é bem conhecido.
Costumo usar um aplicativo muito bom para testar chamadas de APIs, é o Postman, utilizaremos ele para resgatar o Authentication Token e solicitaremos informações ao Microsoft Graph.
Primeiro passo é configurar um Azure Active Directory para conectar com os usuários do Office 365 – este link explica como. Abaixo o que foi configurado:
Para a próxima tela escolha a opção: “Adicionar um aplicativo que minha organização esteja desenvolvendo”
Preencha as seguintes propriedades
Agora vamos autorizar a nossa aplicação a acessar o
Microsoft Graph. Click no botão de adicionar aplicativo e escolha o Microsoft Graph – coloquei todas as permissões porque o intuito é estudar a maioria dos EndPoints, então liberei tudo.
Lembre-se de copiar os EndPoints:
Authorization OAuth 2.0:
https://login.microsoftonline.com/<id>/oauth2/authorize?resource=https://graph.microsoft.com/
Token OAuth:
https://login.microsoftonline.com/<id>/oauth2/token
Agora vamos solicitar a nossa aplicação “Client” para fazer a parte de autenticação, receber o token e aplicar em nossos Headers, e assim ter acesso ao Microsoft Graph – lembrando que esse fluxo de autorização faz parte do Oauth Flow. Abaixo o diagrama que mostra o fluxo.
Escolha o OAuth 2.0 como o tipo de autorização que o post ira realizar e ai em Get New Acess Token tem as seguintes informações:
Agora vamos retornar a foto desse usuário, é só colocar o endereço http://graph.microsoft.com/v1.0/me/photo/$value ou se eu quero pegar de algum usuário especifico http://graph.microsoft.com/v1.0/users/<id>/photo/$value
Agora estamos conectados ao Microsoft Graph.
Referências:
Lambda3 - https://www.lambda3.com.br/2016/11/vamos-falar-do-microsoft-graph/
Microsoft Graph – https://graph.microsoft.io/en-us/docs
Azure Active Directory – https://azure.microsoft.com/pt-br/services/active-directory/
PnP Office – https://github.com/OfficeDev/PnP/wiki
Autenticação do Microsoft Graph: https://graph.microsoft.io/en-us/docs/authorization/auth_overview
Suíte Tecnológica da Microsoft:
- Microsoft Lync, Microsoft Office Communicator ou Skype for Business?
- O que é o Microsoft Azure?
- O que é o Yammer?
- O que é o Microsoft Graph?
- 3 - Office Delve é a novidade da Microsoft que lista informações úteis de forma inteligente
- 2 - Transformando Dados em Insights, Sem perder a Privacidade
- 1 - Microsoft Office Delve Analytics - O que é ?
- O que é o Sway?
Envie seus comentários e sugestões e compartilhe este artigo!
⬛◼◾▪ CONTATO ▪◾◼⬛
brazilsalesforceeffectiveness@gmail.com
