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

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

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

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

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

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

?

登錄Graph 瀏覽器

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

?

輸入正確的賬號和密碼后，點擊確定，系統將引導用戶進行授權確認，如下圖所示

?

?

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

查詢當前用戶的基本信息

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

?

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

查詢當前用戶的個人網盤文件列表

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

?

?

查詢當前用戶的收件箱前10條郵件信息

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

?

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

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

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

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

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

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

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

發送郵件

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

這里需要用到的API是https://graph.microsoft.com/v1.0/me/sendmail，這個接口需要使用POST方法調用，你要發送的郵件內容通過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" }

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

結語

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

陳希章 《Office 365開發入門指南》作者

總結

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

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。