修复使用 Gmail API 的自定义域电子邮件的“邮件客户端未启用”错误

通过 Gmail API 解决自定义域电子邮件的“邮件客户端未启用”问题

使用 C# 和 Gmail API 以及 OAuth2 进行身份验证和电子邮件发送的后端解决方案

using Google.Apis.Auth.OAuth2;
using Google.Apis.Gmail.v1;
using Google.Apis.Gmail.v1.Data;
using Google.Apis.Services;
using MimeKit;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Mail;
namespace GmailAPIExample
{
    public class GmailServiceHandler
    {
        public string SendEmail(string accessToken, string from, List<string> recipients, string subject, string body)
        {
            try
            {
                // Initialize credentials
                var credential = GoogleCredential.FromAccessToken(accessToken).CreateScoped(GmailService.Scope.GmailSend);
                var service = new GmailService(new BaseClientService.Initializer
                {
                    HttpClientInitializer = credential,
                    ApplicationName = "YourAppName"
                });
                // Construct MimeMessage
                var message = new MimeMessage();
                message.From.Add(new MailboxAddress("Sender Name", from));
                foreach (var recipient in recipients)
                {
                    message.To.Add(new MailboxAddress("", recipient));
                }
                message.Subject = subject;
                message.Body = new TextPart("html") { Text = body };
                // Encode message
                var encodedMessage = Convert.ToBase64String(System.Text.Encoding.UTF8.GetBytes(message.ToString()));
                var gmailMessage = new Message { Raw = encodedMessage.Replace("+", "-").Replace("/", "_").Replace("=", "") };
                // Send email
                var request = service.Users.Messages.Send(gmailMessage, "me");
                var response = request.Execute();
                return $"Email sent successfully. Message ID: {response.Id}";
            }
            catch (Exception ex)
            {
                return $"Error sending email: {ex.Message}";
            }
        }
    }
}

替代方案：使用 OAuth2 的 Gmail API 的 Python 脚本

使用 Python、Gmail API 和 google-auth 库进行令牌管理和电子邮件发送的后端解决方案

from google.oauth2.credentials import Credentials
from googleapiclient.discovery import build
import base64
from email.mime.text import MIMEText
def send_email(access_token, sender, recipients, subject, body):
    try:
        # Authenticate the Gmail API
        creds = Credentials(access_token)
        service = build('gmail', 'v1', credentials=creds)
        # Create MIME message
        message = MIMEText(body, 'html')
        message['to'] = ', '.join(recipients)
        message['from'] = sender
        message['subject'] = subject
        raw_message = base64.urlsafe_b64encode(message.as_string().encode('utf-8')).decode('utf-8')
        # Send email
        message_body = {'raw': raw_message}
        sent_message = service.users().messages().send(userId='me', body=message_body).execute()
        return f"Email sent successfully. Message ID: {sent_message['id']}"
    except Exception as e:
        return f"An error occurred: {str(e)}"

有关 Gmail API 和自定义域的常见问题

1. 为什么自定义域经常无法使用 Gmail API？
2. 自定义域需要正确配置 SPF、DKIM 和 DMARC 记录。此外，请确保您的 OAuth 范围包括 GmailService.Scope.GmailSend。
3. 如何验证我的 OAuth 令牌是否具有正确的权限？
4. 使用 GoogleCredential.FromAccessToken() 检查令牌范围的方法。缺少范围通常会导致失败。
5. 调试“邮件客户端未启用”错误的最佳方法是什么？
6. 验证您的 Google Cloud 项目设置，确保域所有权验证，并使用日志记录捕获 API 响应错误。
7. SPF、DKIM 和 DMARC 如何影响电子邮件发送？
8. 这些协议验证您的域的真实性，确保电子邮件受到收件人服务器的信任。通过您的 DNS 提供商配置它们。
9. 我可以使用同一应用程序从多个域发送电子邮件吗？
10. 是的，但请确保每个域都在 Google Cloud Console 中进行验证，并且您的应用为每个用户请求具有适当范围的令牌。

克服电子邮件发送挑战

解决“邮件客户端未启用”问题需要了解 API 限制和特定于域的配置。通过解决权限和身份验证设置，开发人员可以确保他们的应用程序跨帐户类型可靠地运行。

集成 SPF、DKIM 和强大的错误处理功能可进一步提高成功率，提供更流畅的用户体验。适当的规划和工具可以将这个令人沮丧的问题变成开发过程中可管理的步骤。 🌟