Microsoft Graph for Office 365 - 查詢引數（二）

部落格地址：http://blog.csdn.net/FoxDave
本篇繼續介紹Graph的請求語法。

Count

當我們的應用需要知道結果集的數量時，Count是一個很有用的查詢引數。結果的數量將會以屬性的形式返回。

語法

<baseGraphQuery>?$count=<boolean>

示例

獲取當前登入使用者聯絡人的數量：
https://graph.microsoft.com/v1.0/me/contacts?$count=true

Top

Microsoft Graph查詢的結果集有時可能會多於一個響應可以返回的數量。這時我們可以指定Top引數來設定返回結果的最大值。

語法

<baseGraphQuery>?$top=<int>

示例

獲取當前登入使用者OneNote的前兩個notebook：
https://graph.microsoft.com/v1.0/me/onenote/notebooks?$top=2

Skip

Skip是另一個從Microsoft Graph獲取分頁結果時常使用的查詢引數。@odata.nextlink往往會包含一個Skip或SkipToken查詢引數。Skip是用來跳過查詢結果集的前N個結果的。

語法

<baseGraphQuery>?$skip=<int>

示例

獲取當前登入使用者從第11封郵件起的郵件列表：
https://graph.microsoft.com/v1.0/me/messages?$skip=10

Search

Search跟Filter類似，用來從呼叫返回的結果集中獲取子集。在自由文字搜尋表示式的成本上，Search在message和person資源上有優勢。

語法

<baseGraphQuery>?$search=<searchCriteria>

示例
獲取當前登入使用者郵件主體中包含Contoso這個詞的郵件列表：
https://graph.microsoft.com/v1.0/me/messages?$search=”body:Contoso”

Expand

很多時候Microsoft Graph上的實體相互之間是有關聯的。使用Expand查詢引數可以返回複雜資料型別或關聯實體的更多資訊。

語法

<baseGraphQuery>?$expand=<property>

示例
獲取當前使用者的經理的擴充套件資訊：
https://graph.microsoft.com/beta/me?$expand=manager

注意：本示例使用了beta版的端點，User實體只在beta版API中支援Expand查詢引數。

練習

練習文中介紹到的查詢引數，訪問Microsoft Graph Explorer，執行下面的命令：

1. 獲取登入使用者的聯絡人數。
   https://graph.microsoft.com/v1.0/me/contacts?$count=true
2. 獲取登入使用者的OneNote的前兩個記事本。
   https://graph.microsoft.com/v1.0/me/onenote/notebooks?$top=2
3. 獲取登入使用者的第十一封起的郵件。
   https://graph.microsoft.com/v1.0/me/messages?$skip=10
4. 獲取登入使用者的包含“Contoso"內容的郵件。
   https://graph.microsoft.com/v1.0/me/messages?$search=“body:Contoso”
5. 獲取當前登入使用者領導的擴充套件資訊。
   https://graph.microsoft.com/beta/me?$expand=manager