user: getMailTips

  • Статья

Пространство имен: microsoft.graph

Получите подсказки для одного или нескольких получателей, доступные для вошедшего пользователя.

Обратите внимание, что, вызывая POSTgetMailTips действие, можно запросить возврат определенных типов подсказок для нескольких получателей одновременно. Запрошенные подсказки возвращаются в коллекции подсказок .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Mail.Read Mail.Read.Shared
Делегированные (личная учетная запись Майкрософт) Mail.Read Недоступно.
Для приложений Mail.Read Недоступно.

HTTP-запрос

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

Необязательные параметры запросов

Этот метод поддерживает параметры запросов OData для настройки ответа.

Заголовки запросов

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json

Текст запроса

В тексте запроса предоставьте JSON-объект с указанными ниже параметрами.

Свойство Тип Описание
EmailAddresses Коллекция строк Коллекция SMTP-адресов получателей для получения подсказок.
Подсказки почтыПараметры String Перечисление флагов, представляющее запрошенные подсказки. Возможные значения: automaticReplies, customMailTip, deliveryRestriction, externalMemberCount, mailboxFullStatus, , maxMessageSize, moderationStatus, recipientSuggestionsrecipientScopeи totalMemberCount.

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов mailTips в тексте ответа.

Пример

Запрос

В следующем примере показано получение подсказок для указанных получателей, для любых параметров автоматического ответа и полного состояния почтового ящика.

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

{
    "EmailAddresses": [
        "danas@contoso.com",
        "fannyd@contoso.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.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.com"
            },
            "automaticReplies":{
                "message":""
            },
            "mailboxFull":false
        }
    ]
}