Microsoft Graph for Office 365請求語法

部落格地址：http://blog.csdn.net/FoxDave

本篇我們對Microsoft Graph的請求語法進行一下分析。

語法
https://graph.microsoft.com/{version}/{resource}/{id}/{property}?{query-parameters}

HTTP動詞
Microsoft Graph接受以下HTTP請求動詞以確定要執行的操作：

• GET - 從資源讀取資料
• POST - 建立新的資源或執行一個操作
• PATCH - 用新值更新資源
• PUT - 用新的資源替換已存在的
• DELETE - 刪除資源

版本
Microsoft Graph當前支援以下兩個版本：

• v1.0 - 用於生產環境應用程式的常規可用API。
• beta - 可以理解為搶鮮版，裡面包含了一些預覽版的API，但是可能會包含破環性的更新，因此推薦用於開發或測試目的。

通過對比我們可以發現beta版本的API的一些特定端點包含額外的屬性和格式，或一些來自於v1.0的等效變化。
對於Graph做了哪些具體的更新，我們可以通過此頁面檢視。

資源
頂級的端點，指定我們的請求要跟哪個服務進行互動。包含但不限於以下這些：

• Users
• Groups
• Sites
• Drives
• Me
• Devices

很多資源相互之間都是有聯絡的，這使得橫向訪問Graph變得容易。例如，/me/drive，/users/{id}/events等。

Id (可選項)
指定集合中的成員如一個獨立的使用者、組、網站等。

屬性 (可選項)
指定父資源的某個屬性。

查詢引數 (可選項)
修改請求的響應來過濾結果，包含或排除屬性、對結果進行排序等。

練習

瀏覽關於Me(當前登入使用者)的額外資源，增加查詢引數過濾查詢結果。請訪問Graph Explorer執行以下查詢：

1. 獲取登入使用者的OneDrive網站
   https://graph.microsoft.com/v1.0/me/drive

2. 獲取郵件地址以foxdave開頭的使用者
   https://graph.microsoft.com/v1.0/users?$filter=startswith(mail,’foxdave’)

3. 獲取登入使用者的照片
   https://graph.microsoft.com/v1.0/me/photo/$value

4. 從show more samples瞭解更多查詢示例