message: reply

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

Ответ отправителя сообщения в формате JSON или MIME.

При использовании формата JSON:

  • Укажите комментарий или свойство messagebody параметра. При указании обоих типов возвращается ошибка HTTP 400 Bad Request .
  • Если исходное сообщение указывает получателя в свойстве replyTo в формате сообщения Интернета (RFC 2822), отправьте ответ получателям в replyTo , а не получателю в свойстве from .

При использовании формата MIME:

Этот метод сохраняет сообщение в папке Отправленные.

Кроме того, можно создать черновик, чтобы ответить на существующее сообщение и отправить его позже.

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

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

Разрешения

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

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

HTTP-запрос

POST /me/messages/{id}/reply
POST /users/{id | userPrincipalName}/messages/{id}/reply
POST /me/mailFolders/{id}/messages/{id}/reply
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/reply

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

Имя Тип Описание
Authorization string Bearer {token}. Обязательный
Content-Type string Характер данных в теле объекта. Обязательный
Используйте application/json для объекта JSON и text/plain для содержимого MIME.
Prefer: outlook.timezone string Задает часовой пояс для Sent поля ответного сообщения в HTML, создаваемого этим API на основе текста запроса. Значением может быть любой из значений supportedTimeZones, настроенных для пользователя. Если не указано, это Sent поле находится в формате UTC.

Используйте этот заголовок, только если вы указываете Content-Type: application/json заголовок для создания ответного сообщения в ФОРМАТЕ HTML. Если вы используете Content-Type: text/plain заголовок, этот Prefer заголовок не оказывает никакого влияния. Необязательный параметр.

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

При использовании формата JSON предоставьте объект JSON в тексте запроса со следующими параметрами.

Параметр Тип Описание
comment String Добавляемый комментарий. Может быть пустой строкой.
message message Все записываемые свойства, обновляемые в ответном сообщении.

При указании текста в формате MIME предоставьте содержимому MIME применимые заголовки сообщений Интернета, которые в тексте запроса закодированы в формате base64 . Этот метод использует отправителя исходного сообщения в качестве получателя.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 202 Accepted. Он не возвращает ничего в теле ответа.

Если текст запроса содержит неправильно сформированное содержимое MIME, этот метод возвращает 400 Bad Request код ошибки и следующее сообщение об ошибке: "Недопустимая строка base64 для содержимого MIME".

Примеры

Пример 1. Ответ в формате JSON на существующее сообщение

Следующий пример включает комментарий и добавляет получателя в ответное сообщение.

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/v1.0/me/messages/AAMkADA1MTAAAAqldOAAA=/reply
Content-Type: application/json

{
  "message":{
    "toRecipients":[
      {
        "emailAddress": {
          "address":"samanthab@contoso.com",
          "name":"Samantha Booth"
        }
      },
      {
        "emailAddress":{
          "address":"randiw@contoso.com",
          "name":"Randi Welch"
        }
      }
     ]
  },
  "comment": "Samantha, Randi, would you name the group please?"
}

Отклик

Ниже показан пример отклика.

HTTP/1.1 202 Accepted

Пример 2. Ответ в формате MIME на существующее сообщение

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/v1.0/me/messages/AAMkADA1MTAAAAqldOAAA=/reply
Content-type: text/plain

Q29udGVudC1UeXBlOiBhcHBsaWNhdGlvbi9wa2NzNy1taW1lOw0KCW5hbWU9c21pbWUucDdtOw0KCXNtaW1lLXR5cGU9ZW52ZWxvcGVkLWRhdGENCk1pbWUtVmVyc2lvbjogMS4wIChNYWMgT1MgWCBNYWlsIDEzLjAgXCgzNjAxLjAuMTBcKSkNClN1YmplY3Q6IFJlOiBUZXN0aW5nIFMvTUlNRQ0KQ29udGVudC1EaXNwb3Np

Отклик

Ниже показан пример отклика.

HTTP/1.1 202 Accepted

Если текст запроса содержит неправильно отформатированное содержимое MIME, этот метод возвращает следующее сообщение об ошибке.

HTTP/1.1 400 Bad Request
Content-type: application/json

{
    "error": {
        "code": "ErrorMimeContentInvalidBase64String",
        "message": "Invalid base64 string for MIME content."
    }
}