ASP.NET Core 8中基于OAuth实现Gmail API发送邮件及对接问题咨询

一、Gmail API 基础对接步骤（适配邮件验证、消息更新场景） #

• 安装适配包：优先使用Google.Apis.Gmail.v1和Google.Apis.Auth.AspNetCore3，后者专门适配.NET Core身份验证场景，比单独的google.apis.auth更兼容。
• 身份验证配置：
  • 后台服务场景（无需用户授权，用服务账号）：

    // 从服务账号密钥文件初始化凭证
    var credential = GoogleCredential.FromFile("service-account-key.json")
        .CreateScoped(new[] { GmailService.Scope.GmailSend }); // 根据需求选权限，如验证邮件用GmailSend，读取消息用GmailReadonly
    
    // 初始化Gmail服务实例
    var gmailService = new GmailService(new BaseClientService.Initializer
    {
        HttpClientInitializer = credential,
        ApplicationName = "你的应用名称"
    });
    

  • 用户授权场景（需用户登录谷歌账号）：单独指定认证Scheme，避免干扰Identity：

    builder.Services.AddAuthentication()
        .AddGoogle("GmailAuthScheme", options =>
        {
            options.ClientId = "你的谷歌客户端ID";
            options.ClientSecret = "你的谷歌客户端密钥";
            options.Scope.Add(GmailService.Scope.GmailSend);
        });
    

• 核心操作示例：
  • 发送邮箱验证邮件：

    public async Task SendVerificationEmail(string targetEmail, string verifyLink)
    {
        var emailContent = $"To: {targetEmail}\r\nSubject: 邮箱验证\r\n\r\n点击链接完成验证：{verifyLink}";
        var message = new Message
        {
            Raw = Base64UrlEncode(emailContent)
        };
        await gmailService.Users.Messages.Send(message, "me").ExecuteAsync();
    }
    
    // Gmail要求的Base64Url编码方法
    private string Base64UrlEncode(string input)
    {
        var bytes = Encoding.UTF8.GetBytes(input);
        return Convert.ToBase64String(bytes).Replace('+', '-').Replace('/', '_').TrimEnd('=');
    }
    

二、解决谷歌类库与Identity Cookie冲突 #

冲突根源是谷歌认证中间件可能修改默认认证Scheme或Cookie配置，解决方法：

• 明确指定认证Scheme：在调用Gmail API的控制器/方法上，单独指定谷歌认证的Scheme，不影响Identity的默认Scheme：

  [Authorize(AuthenticationSchemes = "GmailAuthScheme")]
  public async Task<IActionResult> SendUserUpdateNotice()
  {
      // 调用Gmail API逻辑
  }
  

• 隔离Cookie配置：给谷歌认证配置独立的Cookie，与Identity的默认Cookie（.AspNetCore.Identity.Application）区分开：

  builder.Services.AddAuthentication()
      .AddGoogle("GmailAuthScheme", options =>
      {
          // 其他配置...
          options.Cookie.Name = "GmailAuthCookie";
          options.Cookie.Path = "/gmail-auth";
      });
  

• 固定默认认证Scheme：保持Identity的Scheme为全局默认，避免谷歌认证覆盖：

  builder.Services.AddAuthentication(options =>
  {
      options.DefaultAuthenticateScheme = IdentityConstants.ApplicationScheme;
      options.DefaultSignInScheme = IdentityConstants.ExternalScheme;
  })
  .AddIdentityCookies()
  .AddGoogle("GmailAuthScheme", options => { /* 谷歌认证配置 */ });
  

三、获取最新Gmail API资源的方法 #

• 查看谷歌官方API参考：在谷歌开发者控制台的Gmail API页面，选择.NET语言的方法列表和代码示例，内容实时更新。
• 查阅NuGet包文档：Google.Apis.Gmail.v1的NuGet详情页下方有官方文档入口，包含最新使用指南。
• 参考官方示例仓库：谷歌apis-client-library-dotnet仓库中包含Gmail相关的.NET示例项目，适配最新版本。

内容的提问来源于stack exchange，提问作者Eugenio