上一篇介紹了Microsoft Graph的基本概念，接下來我們快速體驗一下Microsoft Graph到底能做什么？

為了幫助開發(fā)人員直觀和快速體驗Microsoft Graph的魅力，官方提供了一個專門的工具，叫做Graph 瀏覽器（Graph Explorer）。同時，由于國際版和世紀互聯(lián)版本的Graph接口相關(guān)地址有所不同，所以針對這兩個不同的版本，分別有對應(yīng)的Graph瀏覽器。

國際版Graph 瀏覽器:?https://developer.microsoft.com/zh-cn/graph/graph-explorer

世紀互聯(lián)版 Graph 瀏覽器:?https://developer.microsoft.com/zh-cn/graph/graph-explorer-china

本文將以國際版Graph 瀏覽器作為演示。兩者的功能及使用流程基本類似，具體的差異在于世紀互聯(lián)版的某些接口還在快速開發(fā)中。關(guān)于兩者的細微差別，請隨時可以通過https://developer.microsoft.com/zh-cn/graph/docs/concepts/deployments?進行了解。

下面將簡單演示五個場景，幫助大家理解Microsoft Graph API及其工作原理。

?

登錄Graph 瀏覽器

點擊上圖中的“登錄”按鈕，使用國際版Office 365賬號進行登錄。請注意，我在此前的文章中已經(jīng)介紹了如何申請一個為期一年的Office 365開發(fā)者訂閱。

?

輸入正確的賬號和密碼后，點擊確定，系統(tǒng)將引導(dǎo)用戶進行授權(quán)確認，如下圖所示

?

?

只有你自己點擊了“接受”按鈕，Graph 瀏覽器才能真正訪問到你的數(shù)據(jù)。上面這個授權(quán)方式，其實就是所謂的OAuth的標準機制：Graph 瀏覽器作為一個獨立的應(yīng)用，它并不需要保存你的Office 365賬號信息，它可以得到用戶授權(quán)之后代表用戶去訪問到Graph后臺所連接的資源，包括Office 365的數(shù)據(jù)。

查詢當(dāng)前用戶的基本信息

完成授權(quán)登錄后，我們就可以愉快地使用Microsoft Graph的服務(wù)了。首先，下圖示例了如何獲取當(dāng)前用戶的基本信息。

?

Microsoft Graph的服務(wù)是RESTful的，具體表現(xiàn)在發(fā)起服務(wù)請求，只需要一個Url即可（本例為https://graph.microsoft.com/v1.0/me/），使用的方式也是標準的Http方法（GET,POST等），與此同時，它的返回結(jié)果是業(yè)界應(yīng)用最廣的Json格式。

查詢當(dāng)前用戶的個人網(wǎng)盤文件列表

通過?https://graph.microsoft.com/v1.0/me/drive/root/children?，點擊“轉(zhuǎn)到”，可以查詢當(dāng)前用戶的個人網(wǎng)盤（OneDrive for Business)文件列表。

?

?

查詢當(dāng)前用戶的收件箱前10條郵件信息

使用Microsoft Graph，在得到用戶授權(quán)的前提下，應(yīng)用程序可以讀取到用戶的郵件列表，所使用的服務(wù)請求地址是?https://graph.microsoft.com/v1.0/me/messages

?

默認情況下，這個查詢只會返回前10條郵件信息，并且不區(qū)分郵件目錄，如果需要獲取特定郵箱目錄的郵件信息，請參考下面這樣的語法

https://graph.microsoft.com/v1.0/me/mailFolders/**inbox**/messages

如果想要對返回結(jié)果集做篩選，排序，請參考下面這樣的語法

只選擇前五封郵件?https://graph.microsoft.com/v1.0/me/messages?$top=5

跳過前五封郵件選擇十封郵件?https://graph.microsoft.com/v1.0/me/messages?$skip=5&take=10

按照發(fā)件人郵件地址排序?https://graph.microsoft.com/v1.0/me/messages?$orderby=from/emailAddress/address

更多查詢參數(shù)，請參考https://developer.microsoft.com/zh-cn/graph/docs/overview/query_parameters

發(fā)送郵件

上面演示了幾個場景都是查詢，實際上Microsoft Graph的功能遠遠不止是做查詢，它也可以在用戶授權(quán)下進行某些操作，例如接下來要演示的發(fā)送郵件。

這里需要用到的API是https://graph.microsoft.com/v1.0/me/sendmail，這個接口需要使用POST方法調(diào)用，你要發(fā)送的郵件內(nèi)容通過Json格式進行定義。

{"message": {"subject":"Welcome to Microsoft Graph","body": {"contentType": "Text","content": " Welcome to Microsoft Graph world."},"toRecipients": [{"emailAddress": {"address": "ares@office365devlabs.onmicrosoft.com"}}],"ccRecipients": [{"emailAddress": {"address": "ares@xizhang.com"}}]},"saveToSentItems": "true" }

如果發(fā)送成功的話，返回狀態(tài)碼為200，反之，則會有詳細的錯誤信息。

結(jié)語

本文我介紹了利用Graph 瀏覽器快速體驗Microsoft Graph的強大功能。以上只是舉了幾個常見的例子，如何用支持的功能很多，等待你的發(fā)現(xiàn)，常見的查詢請參考下圖

陳希章 《Office 365開發(fā)入門指南》作者

總結(jié)

以上是生活随笔為你收集整理的【转】通过Graph 浏览器体验Microsoft Graph的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。