如何在Microsoft Graph API SendEmail请求体中添加.ics附件

开发者阿泽

2026-6-22

使用Microsoft Graph API发送带.ics附件邮件的正确操作

要解决.ics内容添加为邮件附件的问题，核心是Graph API要求fileAttachment的contentBytes字段必须填入Base64编码后的二进制内容，不能直接放置文本。具体操作步骤如下：

1. 将.ics文本转换为Base64编码

把你提供的.ics完整文本，通过Base64编码工具（或代码逻辑，比如Python的base64.b64encode()、JavaScript的btoa()）转换为Base64字符串。例如，你给出的.ics内容转换后会生成一段长字符串。

2. 修改请求体的附件配置

调整请求体中attachments数组的参数，确保：

name设置为正确的文件名（如"invite.ics"）
contentType改为"text/calendar"（让邮件客户端识别为日历邀请，而非通用二进制文件）
contentBytes填入转换后的Base64字符串

3. 完整请求体示例

{
  "message": {
    "subject": "<MAIL_SUBJECT>",
    "body": {
      "contentType": "HTML",
      "content": "<!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN>\n<html>\n<head>\n<meta http-equiv=content-type content=text/html; charset=ISO-8859-1>\n<style>\nbody{\n                font-family:Calibri,Verdana, Geneva, sans-serif;\n                }\n</style>\n</head>\n<body bgcolor=#ffffff text=#000000>\n\nstuff here\n\n</body>\n</html>\n"
    },
    "toRecipients": [
      {
        "emailAddress": {
          "address": "<TO_EMAILADDRESS>"
        }
      }
    ],
    "attachments": [
      {
        "@odata.type": "#microsoft.graph.fileAttachment",
        "name": "invite.ics",
        "contentType": "text/calendar",
        "contentBytes": "BASE64_ENCODED_ICS_CONTENT_HERE"
      }
    ],
    "from": {
      "emailAddress": {
        "name": "mail",
        "address": "<test@mail.com>"
      }
    }
  },
  "saveToSentItems": "true"
}