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