反馈 编辑

user： getMailTips

  • 项目

命名空间：microsoft.graph

获取登录用户可用的一个或多个收件人的邮件 提示。

请注意，通过调用POST``getMailTips操作，可以请求同时为多个收件人返回特定类型的邮件提示。 请求的邮件提示在邮件 提示 集合中返回。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） Mail.Read、Mail.Read.Shared
委派（个人 Microsoft 帐户） Mail.Read
应用程序 Mail.Read

HTTP 请求

POST /me/getMailTips
POST /users/{id|userPrincipalName}/getMailTips

可选的查询参数

此方法支持 OData 查询参数 来帮助自定义响应。

请求标头

标头 值
Authorization Bearer {token}。必需。
Content-Type application/json

请求正文

在请求正文中，提供具有以下参数的 JSON 对象。

属性 类型 说明
EmailAddresses String 集合 要获取邮件提示的收件人的 SMTP 地址的集合。
MailTipsOptions String 表示请求的邮件提示的标志的枚举。 可能的值是：、automaticReplies、deliveryRestriction``customMailTip、、externalMemberCount、mailboxFullStatus、maxMessageSize、recipientScope``moderationStatus``recipientSuggestions、和 totalMemberCount。

响应

如果成功，此方法在响应 200 OK 正文中返回 响应代码和 mailTips 对象集合。

示例

请求

下面的示例获取任何自动答复设置和邮箱已满状态的指定收件人的邮件提示。

POST https://graph.microsoft.com/v1.0/me/getMailTips
Content-Type: application/json

{
    "EmailAddresses": [
        "danas@contoso.onmicrosoft.com", 
        "fannyd@contoso.onmicrosoft.com"
    ],
    "MailTipsOptions": "automaticReplies, mailboxFullStatus"
}
响应

这是一个示例响应。注意：为提高可读性，可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.mailTips)",
    "value":[
        {
            "emailAddress":{
                "name":"",
                "address":"danas@contoso.onmicrosoft.com"
            },
            "automaticReplies":{
                "message":"<style type=\"text/css\" style=\"\">\r\n<!--\r\np\r\n\t{margin-top:0;\r\n\tmargin-bottom:0}\r\n-->\r\n</style>\r\n<div dir=\"ltr\">\r\n<div id=\"x_divtagdefaultwrapper\" style=\"font-size:12pt; color:#000000; background-color:#FFFFFF; font-family:Calibri,Arial,Helvetica,sans-serif\">\r\n<p>Hi, I am on vacation right now. I'll get back to you after I return.<br>\r\n</p>\r\n</div>\r\n</div>",
                "messageLanguage":{
                    "locale":"en-US",
                    "displayName":"English (United States)"
                },
                "scheduledStartTime": {
                    "dateTime": "2018-08-07T02:00:00.0000000",
                    "timeZone": "UTC"
                },
                "scheduledEndTime": {
                    "dateTime": "2018-08-09T02:00:00.0000000",
                    "timeZone": "UTC"
                }
            },
            "mailboxFull":false
        },
        {
            "emailAddress":{
                "name":"",
                "address":"fannyd@contoso.onmicrosoft.com"
            },
            "automaticReplies":{
                "message":""
            },
            "mailboxFull":false
        }
    ]
}