win10 uwp 使用 Microsoft.Graph 发送邮件

在 2018 年 10 月 13 号参加了张队长的 Office 365 训练营学习如何开发 Office 365 插件和 OAuth 2.0 开发，于是我就使用 UWP 尝试使用 Microsoft.Graph 经过了一天的测试终于成功使用发送邮件

本文告诉大家如何在 UWP 调用 Microsoft.Graph 发送邮件

在仔细阅读了Microsoft Graph 桌面应用程序 - 陈希章的文章之后，按照文章的方法尝试了很久终于成功发送了邮件

可以使用 Microsoft.Graph 调用 Office 365 的几乎所有功能，但是我只有成功使用邮件的功能，暂时就先告诉大家如何在 UWP 使用 Microsoft.Graph 发送邮件

之后的其他功能等我跑通了，再告诉大家

因为 Microsoft.Graph 开发速度是很快的，本文安装的 Nuget 都会告诉大家指定的版本，防止因为微软的版本修改而让大家无法按照本文提供的方式

注册应用

首先登陆 Microsoft Applications 平台，在登陆之后可以看到下面界面

在这里插入图片描述

本文用的例子都是使用国际版的 Office 365 版本，而不会使用国内的版本，因为国内的版本少了很多功能

点击添加应用，随意给一个应用的命名，我这里给了一个 LasecouDofalerJornowserewel 应用

在这里插入图片描述

需要记下程序的 ID 在应用会用到

在这里插入图片描述

添加权限，要发送邮件，需要添加 "User.Read", "Mail.Read", "Mail.Send","Files.Read" 权限

在这里插入图片描述

点击添加权限

在这里插入图片描述

点击添加应用程序权限

在这里插入图片描述

关于权限这一步，请先照着点，详细请看Office 365 开发入门指南

还有这个步骤最重要的，点击下方的保存，有小伙伴就告诉我按照我的教程无法成功，过了很长的时间才发现是没有保存

创建 UWP 程序

打开 VisualStudio 创建一个 UWP 项目，尽可能选择新版本，只有在自己跑通了之后才使用小的版本，防止因为版本问题在尝试开发的时候做到放弃

我创建了一个 BalreMahouVoomawbatu 项目，最低版本是 17134 也就是现在最新的

在这里插入图片描述

安装 nuget 包

右击项目，点击管理 Nuget 包

先点击安装 Microsoft.Graph 的 1.11 版本

在这里插入图片描述

然后勾选包含预发行版，找到 Microsoft.Identity.Client 的 2.2 版本

在这里插入图片描述

添加访问权限

打开 UWP 的 MainPage.xaml.cs 文件，添加 Load 事件

在这里插入图片描述

在 Load 事件的函数添加自己的代码，首先使用 DelegateAuthenticationProvider 拿到访问的权限，在 Microsoft.Graph 的所有访问都需要先获得 OAuth 的权限

在文件的最上面添加引用

using Microsoft.Graph;

然后在 MainPage_Loaded 添加下面代码

            var provider = new DelegateAuthenticationProvider(AuthenticateRequestAsyncDelegate);

创建方法 AuthenticateRequestAsyncDelegate 请看下面

        private Task AuthenticateRequestAsyncDelegate(HttpRequestMessage request)
        {
            
        }

现在的代码还是无法运行通过的，需要在 AuthenticateRequestAsyncDelegate 添加访问的 Token 拿到权限

还记得刚才记下来的程序 ID 现在就需要用到他了

在这里插入图片描述

请看下面代码

        private Task AuthenticateRequestAsyncDelegate(HttpRequestMessage request)
        {

            string clientID = "2f56798a-66f7-4330-9bc4-d3a8a0898642"; //这个ID是我创建的一个临时App的ID，请替换为自己的
            string[] scopes = {"User.Read", "Mail.Read", "Mail.Send", "Files.Read"};

        }

在这里插入图片描述

通过 clientID 创建 Microsoft.Identity.Client.PublicClientApplication 请看代码

             string clientID = "2f56798a-66f7-4330-9bc4-d3a8a0898642"; //这个ID是我创建的一个临时App的ID，请替换为自己的
            string[] scopes = {"User.Read", "Mail.Read", "Mail.Send", "Files.Read"};

            var clientApplication = new PublicClientApplication(clientID);

使用 clientApplication 获得权限

            var authenticationResult = await clientApplication.AcquireTokenAsync(scopes);

运行到这一步就会请求用户的权限

从获取到的权限给传入的参数

            request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", authenticationResult.AccessToken);

详细关于 OAuth 获取权限的请看张队长的博客，这里的博客很多，请看文章的最后

现在可以看到的 AuthenticateRequestAsyncDelegate 代码是这样

        private async Task AuthenticateRequestAsyncDelegate(HttpRequestMessage request)
        {

            string clientID = "2f56798a-66f7-4330-9bc4-d3a8a0898642"; //这个ID是我创建的一个临时App的ID，请替换为自己的
            string[] scopes = { "User.Read", "Mail.Read", "Mail.Send", "Files.Read" };

            var clientApplication = new PublicClientApplication(clientID);

            var authenticationResult = await clientApplication.AcquireTokenAsync(scopes);

            request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", authenticationResult.AccessToken);
        }

注意需要替换这里的 clientID 为你自己的 clientID 当然代码可以按照我的使用，因为用我的 ID 也是没问题

发送邮件

在获取到权限之后，很容易就可以调用 Microsoft.Graph 发送邮件，请看代码

创建 GraphServiceClient 之后调用 SendMail 就可以，邮件里面的内容请自己修改

            await client.Me.SendMail(new Message()
            {
                Subject = "调用Microsoft Graph发出的邮件",
                Body = new ItemBody()
                {
                    ContentType = BodyType.Text,
                    Content = "这是一封调用了Microsoft Graph服务发出的邮件，范例参考 https://github.com/chenxizhang/office365dev"
                },
                ToRecipients = new[]
                {
                    new Recipient()
                    {
                        EmailAddress = new EmailAddress() {Address = "lindexi_gd@outlook.com"}
                    }
                }
            }, SaveToSentItems: true /*保存到发送邮件夹*/).Request().PostAsync();