如何通过MS Graph API实现邮件Snooze（延迟提醒）功能？

Outlook的Snooze功能核心是设置邮件的提醒时间，并非单纯移动文件夹，用Graph API可以通过以下步骤实现：

• 获取目标邮件ID：先通过GET /me/messages（或对应文件夹的查询接口）拿到要设置推迟提醒的邮件ID。
• 更新邮件提醒属性：发送PATCH请求修改邮件的提醒相关字段，这是实现Snooze的关键：
  • 请求端点：PATCH /me/messages/{message-id}
  • 请求体示例（设置1小时后提醒）：

    {
      "isReminderOn": true,
      "reminderDateTime": {
        "dateTime": "2024-05-20T16:45:00.0000000",
        "timeZone": "Asia/Shanghai"
      }
    }
    

    注意reminderDateTime要使用ISO 8601格式，时区需和用户邮箱时区匹配，或明确指定。
• 可选：模拟原生Snooze的文件夹移动：如果要和Outlook客户端行为完全一致，设置完提醒后可以把邮件移到默认的"Snoozed"文件夹：
  1. 先通过GET /me/mailFolders查询到显示名称为"Snoozed"的文件夹ID；
  2. 发送POST /me/messages/{message-id}/move请求，请求体如下：

  {
    "destinationId": "{snoozed-folder-id}"
  }
  

权限要求 #

确保你的应用已申请Mail.ReadWrite权限，这是修改邮件属性和移动邮件的必要条件。如果操作的是其他用户的邮件，把请求中的/me替换为/users/{user-id}即可。

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