Microsoft Graph for Office 365 - 查询参数（一）

博客地址：http://blog.csdn.net/FoxDave
上一篇我们介绍了Microsoft Graph的查询语法。本篇我们开始介绍Microsoft Graph中的请求可用的查询参数。由于篇幅有限，所有的查询参数可以访问此页面查看。

Filter

Filter是我们使用的较普遍的一个查询参数。即从总的结果集中通过一些条件筛选出结果的子集。

语法

<baseGraphQuery>?$filter=<conditions>

示例

获取显示名以大写字母A开头的用户：
https://graph.microsoft.com/v1.0/users?$filter=startswith(displayName,‘A’)

Select

Select允许获取默认属性集合的子集或超集。这对当我们获取了相当多数量的默认属性的记录集时特别有帮助。通过限制返回属性的数量(只保留我们的应用需要的那些)以降低内存和网络带宽占用。

语法

<baseGraphQuery>?$select=<property1>,<property2>,…,<propertyN>

示例

获取登录用户的OneDrive网站中文件的名称、大小和网络URL：
https://graph.microsoft.com/v1.0/me/drive/root/children?$select=name,size,webUrl

OrderBy

OrderBy会对返回的结果以指定的属性进行排序。某些API支持多属性排序。

语法

<baseGraphQuery>?$orderby=<property1>,<property2>,…,<propertyN>

示例

获取当前登录用户的联系人并以生日排序(默认升序)：
https://graph.microsoft.com/v1.0/me/contacts?$orderby=birthday

另外，我们可以通过在属性名后面添加“ asc”或“ desc”来指定升序或者降序。

示例

获取当前登录用户的联系人并以生日降序排列：
https://graph.microsoft.com/v1.0/me/contacts?$orderby=birthday

Format

指定Microsoft Graph的端点可以提供以不同格式返回结果的能力。这可能包括可下载的CSV文件、JSON或其他流行的格式。支持格式化查询参数的端点默认会有一个格式，但是允许我们指定其他支持的格式。

语法

<baseGraphQuery>?$format=<formatValue>

示例

获取Office 365组活动的报告的JSON格式：
https://graph.microsoft.com/beta/reports/getOffice365GroupsActivityGroupCounts(period=‘D7’)?$format=application/json

获取Office 365组活动的报告的CSV格式：
https://graph.microsoft.com/beta/reports/getOffice365GroupsActivityGroupCounts(period=‘D7’)?$format=text/csv

注意：本示例需要以Office 365全局管理员或Azure AD管理员的身份登录Graph资源管理器进行测试。

练习

练习文中介绍到的查询参数，访问Microsoft Graph Explorer，执行下面的命令：

1. 获取当前用户高优先级的邮件。
   https://graph.microsoft.com/v1.0/me/messages?$filter=importance eq ‘High’
2. 获取当前用户OneDrive网站文件的名称、大小和URL。
   https://graph.microsoft.com/v1.0/me/drive/root/children?$select=name,size,webUrl
3. 获取当前用户的联系人并以生日排序。
   https://graph.microsoft.com/v1.0/me/contacts?$orderby=birthday