大网数据广告活动
Microsoft Graph 接口

使用 Outlook 邮件 API 从其他用户发送 Outlook 邮件

· 52CE 我爱测

使用“代理发送”和“代表发送”权限,从 Microsoft Graph 中的其他用户身份或共享邮箱发送 Outlook 邮件。

Exchange Online 提供的邮箱权限允许用户从其他用户身份、通讯组列表、组、资源或共享邮箱发送邮件。 Microsoft Graph 也支持此功能,但是最终结果各不相同,具体取决于在 Exchange Online 中授予的准确权限以及用于发送邮件的 API。

权限

两种类型的权限适用于从另一个用户发送消息:

Microsoft Graph 权限

若要从其他用户身份发送邮件,使用用户令牌的应用程序需使用 the Mail.Send.Shared 权限。

Note: 使用应用程序令牌而不是用户令牌且已拥有管理员授予的 Mail.Send 权限的应用程序可以组织中的任何用户身份发送邮件,只需通过用户的邮箱正常发送邮件即可。

邮箱权限

以下两种权限会影响从其他用户身份发送邮件的最终结果:代表发送 和 代理发送。 使用 Mail.Send.Shared 权限登录应用程序的用户必须至少拥有这两种权限之一,这些权限已授予从其中发送邮件的邮箱、组或通讯组列表。

Note: 目前无法使用 Microsoft Graph 来查询经过身份验证的用户对哪些邮箱具有权限。

代表发送

使用此权限时,电子邮件的收件人将在其电子邮件客户端收到此邮件是使用你的应用程序代表其他用户发送的指示。

指示邮件是由一个用户代表另一个用户发送的 Outlook 网页版屏幕截图

它在 Microsoft Graph 显示为 sender(实际发送邮件的用户)和 from(代表发送邮件的用户/组/等)属性。

{
  "id": "AAMkAGE1...",
  "subject": "Send mail test",
  "sender": {
    "emailAddress": {
      "name": "Adele Vance",
      "address": "AdeleV@contoso.com"
    }
  },
  "from": {
    "emailAddress": {
      "name": "Pradeep Gupta",
      "address": "PradeepG@contoso.com"
    }
  }
}

用户可以使用 Outlook 将其自己邮箱的这种权限授予其他用户。 管理员可以在 Microsoft 365 管理中心为任何邮箱、组或通讯组列表授予此权限。

代理发送

使用此权限时,不会显示邮件是以其他用户身份发送的指示。sender 和 from 属性具有相同的值。

用户无法为其邮箱授予此权限。 管理员可以在 Microsoft 365 管理中心授予此权限。

通过 Microsoft Graph 发送

可以通过直接发送或创建草稿然后再发送这两种方式,从其他用户身份发送邮件。

如要从其他用户身份发送,请设置要从其中向用户电子邮件地址发送的邮件上的 from 属性。 无需设置 sender 属性 - Microsoft Graph 将会根据授予已登录用户的邮箱权限进行相应的设置。

例如,若要从 sales@contoso.com 组发送邮件,请按如下所示配置邮件。

{
  "subject": "January sales report",
  "toRecipients": [
    {
      "emailAddress": {
        "address": "MeganB@contoso.com"
      }
    }
  ],
  "from": {
    "emailAddress": {
      "address": "sales@contoso.com"
    }
  }
}

已发送邮件行为

邮件发送后,可将其保存到发送用户的“已发送邮件”文件夹、发件人用户的“已发送邮件”文件夹,或同时保存到这两个位置。也可以不进行保存。

Note: 如果邮件是从没有邮箱的地址(例如通讯组列表)发送,则发件人用户没有“已发送邮件”。

  • 如果应用程序通过使用 /me 终结点(或 /users/{user-id},其中 user-id 对应于已登录的用户)发送,邮件则会默认保存至发送用户的“已发送邮件”文件夹。
  • 如果应用程序通过使用 /users/{user-id}(其中 user-id 对应于已登录的用户)发送,邮件则会默认保存至发件人用户的“已发送邮件”文件夹。

    IMPORTANT 若要以此方式发送,除了 代表发送 或 代理发送 权限之外,发送用户还必须具有 完全访问 邮箱权限。

以下其他外部因素可能会改变默认行为:

  • 管理员将发件人用户的邮箱更新为始终将从代理发送的邮件副本保存至其“已发送邮件”。
  • 通过在 send mail 请求中将 saveToSentItems 属性设为 false,可以防止邮件被保存至“已发送邮件”文件夹。 但是,如果管理员已配置“始终保存副本”设置,则邮件将被保存至发件人用户的“已发送邮件”文件夹。

示例

示例 1:通过 /me 终结点成功发送

在此示例中,Adele Vance 已为 Allan Deyoung 的邮箱授予 代表发送 权限。

请求
POST /me/sendmail
Content-Type: application/json

{
  "message": {
    "subject": "Expense reports",
    "body": {
      "contentType": "text",
      "content": "Have you submitted your expense reports yet?"
    },
    "toRecipients": [
      {
        "emailAddress": {
          "address": "MeganB@contoso.com"
        }
      }
    ],
    "from": {
      "emailAddress": {
        "address": "AllanD@contoso.com"
      }
    }
  }
}
响应
HTTP/1.1 202 Accepted

示例 2:在无权限的情况下,尝试发送失败

在此示例中,Adele Vance 尝试从 Patti Fernandez 身份发送电子邮件,但他并没有被授予 代表发送 或 代理发送 权限。响应包含 ErrorSendAsDenied 错误。

请求
POST /me/sendmail
Content-Type: application/json

{
  "message": {
    "subject": "Support ticket",
    "body": {
      "contentType": "text",
      "content": "I noticed you opened a support ticket yesterday..."
    },
    "toRecipients": [
      {
        "emailAddress": {
          "address": "MeganB@contoso.com"
        }
      }
    ],
    "from": {
      "emailAddress": {
        "address": "PattiF@contoso.com"
      }
    }
  }
}
响应
HTTP/1.1 403 Forbidden
Content-Type: application/json

{
  "error": {
    "code": "ErrorSendAsDenied",
    "message": "The user account which was used to submit this request does not have the right to send mail on behalf of the specified sending account. Cannot submit message.",
    "innerError": {
      "request-id": "24e7991e-01ae-4cc2-8e06-532a96fd8948",
      "date": "2019-01-16T18:53:25"
    }
  }
}

后续步骤

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 jasonjoh)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。