在 C# 中使用 Outlook 365 Graph API 获取电子邮件阅读时间戳

通过 Graph API 访问 Outlook 365 中电子邮件的读取时间戳

图 API 集成的 C# 实现

using Microsoft.Graph;
using Microsoft.Identity.Client;
using System;
using System.Net.Http.Headers;
using System.Threading.Tasks;

class Program
{
    private const string clientId = "YOUR_CLIENT_ID";
    private const string tenantId = "YOUR_TENANT_ID";
    private const string clientSecret = "YOUR_CLIENT_SECRET";
    private static GraphServiceClient graphClient = null;

    static async Task Main(string[] args)
    {
        var authProvider = new ClientCredentialProvider(clientId, clientSecret, tenantId);
        graphClient = new GraphServiceClient(authProvider);
        var userMail = "user@example.com";
        await GetEmailReadTimestamp(userMail);
    }

    private static async Task GetEmailReadTimestamp(string userEmail)
    {
        var messages = await graphClient.Users[userEmail].Messages
            .Request()
            .Select("receivedDateTime,isRead")
            .GetAsync();

        foreach (var message in messages)
        {
            if (message.IsRead.HasValue && message.IsRead.Value)
            {
                Console.WriteLine($"Email read on: {message.ReceivedDateTime}");
            }
        }
    }
}

用于验证和获取数据的后端脚本

使用 C# 进行身份验证和数据检索

public class ClientCredentialProvider : IAuthenticationProvider
{
    private IConfidentialClientApplication _app;
    private string[] _scopes;

    public ClientCredentialProvider(string clientId, string clientSecret, string tenantId)
    {
        _app = ConfidentialClientApplicationBuilder.Create(clientId)
            .WithTenantId(tenantId)
            .WithClientSecret(clientSecret)
            .Build();
        _scopes = new string[] { "https://graph.microsoft.com/.default" };
    }

    public async Task<string> GetAccessTokenAsync()
    {
        var result = await _app.AcquireTokenForClient(_scopes).ExecuteAsync();
        return result.AccessToken;
    }

    public async Task AuthenticateRequestAsync(HttpRequestMessage request)
    {
        var accessToken = await GetAccessTokenAsync();
        request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken);
    }
}

Graph API 的电子邮件管理常见问题解答

1. Graph API 可以跟踪电子邮件的阅读时间吗？
2. 是的，Graph API 可以跟踪电子邮件何时被标记为已读，但它不直接提供读取时间戳。开发人员通常使用“receivedDateTime”作为此信息的代理。
3. 是否可以使用 Graph API 访问用户收件箱中的所有电子邮件？
4. 是的，通过适当的权限，Graph API 允许应用程序访问用户收件箱中的所有电子邮件。
5. 身份验证如何与 Microsoft Graph API 配合使用？
6. Graph API 的身份验证通过 Azure Active Directory (Azure AD) 进行处理，根据应用程序的要求使用委派权限或应用程序权限。
7. 我可以使用 Graph API 发送电子邮件吗？
8. 是的，只要授予必要的权限，Graph API 支持代表用户或应用程序本身发送电子邮件。
9. 如何使用 Graph API 处理速率限制？
10. Graph API 强制执行速率限制以确保公平使用。开发人员应在其应用程序中实现错误处理和退避逻辑，以管理速率限制响应。