• 通过Graph 浏览器体验Microsoft Graph
    • 登录Graph 浏览器
    • 查询当前用户的基本信息
    • 查询当前用户的个人网盘文件列表
    • 查询当前用户的收件箱前10条邮件信息
    • 发送邮件
    • 结语

    通过Graph 浏览器体验Microsoft Graph

    作者：陈希章 发表于 2017年3月18日

    上一篇介绍了Microsoft Graph的基本概念，接下来我们快速体验一下Microsoft Graph到底能做什么？

    为了帮助开发人员直观和快速体验Microsoft Graph的魅力，官方提供了一个专门的工具，叫做Graph 浏览器（Graph Explorer）。同时，由于国际版和世纪互联版本的Graph接口相关地址有所不同，所以针对这两个不同的版本，分别有对应的Graph浏览器。

    1. 国际版Graph 浏览器: https://developer.microsoft.com/zh-cn/graph/graph-explorer
    2. 世纪互联版 Graph 浏览器: https://developer.microsoft.com/zh-cn/graph/graph-explorer-china

    本文将以国际版Graph 浏览器作为演示。两者的功能及使用流程基本类似，具体的差异在于世纪互联版的某些接口还在快速开发中。关于两者的细微差别，请随时可以通过https://developer.microsoft.com/zh-cn/graph/docs/concepts/deployments 进行了解。

    下面将简单演示五个场景，帮助大家理解Microsoft Graph API及其工作原理。

    登录Graph 浏览器

    Graph浏览器

    点击上图中的“登录”按钮，使用国际版Office 365账号进行登录。请注意，我在此前的文章中已经介绍了如何申请一个为期一年的Office 365开发者订阅。

    Graph浏览器登录

    输入正确的账号和密码后，点击确定，系统将引导用户进行授权确认，如下图所示

    Graph浏览器身份授权

    只有你自己点击了“接受”按钮，Graph 浏览器才能真正访问到你的数据。上面这个授权方式，其实就是所谓的OAuth的标准机制：Graph 浏览器作为一个独立的应用，它并不需要保存你的Office 365账号信息，它可以得到用户授权之后代表用户去访问到Graph后台所连接的资源，包括Office 365的数据。

    查询当前用户的基本信息

    完成授权登录后，我们就可以愉快地使用Microsoft Graph的服务了。首先，下图示例了如何获取当前用户的基本信息。
    查询当前用户的基本信息

    Microsoft Graph的服务是RESTful的，具体表现在发起服务请求，只需要一个Url即可（本例为https://graph.microsoft.com/v1.0/me/），使用的方式也是标准的Http方法（GET,POST等），与此同时，它的返回结果是业界应用最广的Json格式。

    查询当前用户的个人网盘文件列表

    通过 https://graph.microsoft.com/v1.0/me/drive/root/children ，点击“转到”，可以查询当前用户的个人网盘（OneDrive for Business)文件列表。

    查询当前用户的个人网盘文件列表

    查询当前用户的收件箱前10条邮件信息

    使用Microsoft Graph，在得到用户授权的前提下，应用程序可以读取到用户的邮件列表，所使用的服务请求地址是 https://graph.microsoft.com/v1.0/me/messages

    获取用户的邮件列表

    默认情况下，这个查询只会返回前10条邮件信息，并且不区分邮件目录，如果需要获取特定邮箱目录的邮件信息，请参考下面这样的语法

    https://graph.microsoft.com/v1.0/me/mailFolders/**inbox**/messages

    如果想要对返回结果集做筛选，排序，请参考下面这样的语法

    1. 只选择前五封邮件 https://graph.microsoft.com/v1.0/me/messages?$top=5
    2. 跳过前五封邮件选择十封邮件 https://graph.microsoft.com/v1.0/me/messages?$skip=5&take=10
    3. 按照发件人邮件地址排序 https://graph.microsoft.com/v1.0/me/messages?$orderby=from/emailAddress/address

    更多查询参数，请参考https://developer.microsoft.com/zh-cn/graph/docs/overview/query_parameters

    发送邮件

    上面演示了几个场景都是查询，实际上Microsoft Graph的功能远远不止是做查询，它也可以在用户授权下进行某些操作，例如接下来要演示的发送邮件。

    这里需要用到的API是https://graph.microsoft.com/v1.0/me/sendmail，这个接口需要使用POST方法调用，你要发送的邮件内容通过Json格式进行定义。

    1. {
    2.   "message": {
    3.     "subject":"Welcome to Microsoft Graph",
    4.     "body": {
    5.       "contentType": "Text",
    6.       "content": " Welcome to Microsoft Graph world."
    7.     },
    8.     "toRecipients": [
    9.       {
    10.         "emailAddress": {
    11.           "address": "ares@office365devlabs.onmicrosoft.com"
    12.         }
    13.       }
    14.     ],
    15.     "ccRecipients": [
    16.       {
    17.         "emailAddress": {
    18.           "address": "ares@xizhang.com"
    19.         }
    20.       }
    21.     ]
    22.   },
    23.   "saveToSentItems": "true"
    24. }

    发送邮件

    如果发送成功的话，返回状态码为200，反之，则会有详细的错误信息。

    结语

    本文我介绍了利用Graph 浏览器快速体验Microsoft Graph的强大功能。以上只是举了几个常见的例子，如何用支持的功能很多，等待你的发现，常见的查询请参考下图

    更多场景