使用Google.Apis.GmailService无法永久删除Gmail邮件求助

使用Google.Apis操作Gmail服务器删除邮件时，可正常登录并读取邮件，但调用以下代码后，仅在本地GmailService实例中“标记”删除，再次检查服务器时邮件仍存在：

GmailService.Users.Messages.Delete("my-email@gmail.com", email.Id);
GmailService.Users.Threads.Delete("my-email@gmail.com", email.ThreadId);

已确认email.Id和email.ThreadId有效，且已获取Gmail全权限（MailGoogleCom scope，对应“读取、撰写、发送及永久删除Gmail中的所有邮件”）。授权及邮件列表获取代码如下：

private static readonly string[] Scopes = { GmailService.Scope.MailGoogleCom};

// 授权逻辑
GmailService GmailService = new();               
using (FileStream stream = new("client_secret.json", FileMode.Open, FileAccess.Read))
{
    string credPath = System.Environment.GetFolderPath(System.Environment.SpecialFolder.Personal);
    credPath = System.IO.Path.Combine(credPath, ".credentials/gmail-dotnet-quickstart.json");
    UserCredential credential = GoogleWebAuthorizationBroker.AuthorizeAsync(
        GoogleClientSecrets.FromStream(stream).Secrets, 
        Scopes, 
        "my-email@gmail.com", 
        CancellationToken.None, 
        new FileDataStore(credPath, true)).Result;
    this.GmailService = new(new BaseClientService.Initializer()
    {
        HttpClientInitializer = credential,
        ApplicationName = "AppName"
    });
}

// 获取邮件列表
UsersResource.MessagesResource.ListRequest inboxlistRequest = GmailService.Users.Messages.List("my-email@gmail.com");
inboxlistRequest.LabelIds = "INBOX";
inboxlistRequest.IncludeSpamTrash = false;
ListMessagesResponse EmailListResponse = inboxlistRequest.Execute();

1. 核心问题：未执行API请求
   Google .NET客户端库中，所有API操作请求（比如Delete）仅创建请求对象，不会自动发送到服务器，必须调用Execute()（同步）或ExecuteAsync()（异步）方法才会触发实际的HTTP请求，完成服务器端操作。

2. 删除逻辑优化

• 如果目标是删除整个邮件线程，只需调用Threads.Delete().Execute()，线程内所有关联消息会被一并删除，无需单独删除单条消息。
• 若仅需删除单条消息，调用Messages.Delete().Execute()即可，不会影响线程（除非该消息是线程的最后一条）。

3. 优先使用异步方法
   推荐使用ExecuteAsync()配合await关键字，避免阻塞主线程，符合.NET异步编程最佳实践。

同步删除版本 #

// 删除单条消息
GmailService.Users.Messages.Delete("my-email@gmail.com", email.Id).Execute();

// 或删除整个线程（二选一即可，无需重复操作）
GmailService.Users.Threads.Delete("my-email@gmail.com", email.ThreadId).Execute();

异步删除版本（推荐） #

// 异步删除单条消息
await GmailService.Users.Messages.Delete("my-email@gmail.com", email.Id).ExecuteAsync();

// 或异步删除整个线程
await GmailService.Users.Threads.Delete("my-email@gmail.com", email.ThreadId).ExecuteAsync();

完整异步流程示例 #

// 授权逻辑改为异步（推荐）
private async Task<GmailService> InitializeGmailServiceAsync()
{
    using (FileStream stream = new("client_secret.json", FileMode.Open, FileAccess.Read))
    {
        string credPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Personal), ".credentials/gmail-dotnet-quickstart.json");
        UserCredential credential = await GoogleWebAuthorizationBroker.AuthorizeAsync(
            GoogleClientSecrets.FromStream(stream).Secrets,
            Scopes,
            "my-email@gmail.com",
            CancellationToken.None,
            new FileDataStore(credPath, true));

        return new GmailService(new BaseClientService.Initializer()
        {
            HttpClientInitializer = credential,
            ApplicationName = "AppName"
        });
    }
}

// 异步获取邮件并删除
private async Task DeleteEmailsAsync()
{
    var gmailService = await InitializeGmailServiceAsync();
    
    // 获取收件箱邮件列表
    var inboxListRequest = gmailService.Users.Messages.List("my-email@gmail.com");
    inboxListRequest.LabelIds = "INBOX";
    inboxListRequest.IncludeSpamTrash = false;
    var emailListResponse = await inboxListRequest.ExecuteAsync();

    if (emailListResponse.Messages != null)
    {
        foreach (var email in emailListResponse.Messages)
        {
            // 异步删除邮件线程
            await gmailService.Users.Threads.Delete("my-email@gmail.com", email.ThreadId).ExecuteAsync();
        }
    }
}

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