博客地址: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查询参数。