message: replyAll

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

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

  • Укажите либо комментарий, либо свойство текста параметра message . Указание обоих параметров вернет ошибку 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}/replyAll
POST /users/{id | userPrincipalName}/messages/{id}/replyAll
POST /me/mailFolders/{id}/messages/{id}/replyAll
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/replyAll

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

Имя Тип Описание
Authorization string Bearer {token}. Обязательный
Content-Type string Характер данных в теле объекта. Обязательный
Использование application/json для объекта JSON и text/plain содержимого MIME
Prefer: outlook.timezone string Устанавливает часовой пояс для Sent поля ответного сообщения в HTML, создаваемого этим API на основе текста запроса. Значением может быть любое из поддерживаемых часовых поясов , настроенных для пользователя. Если параметр не указан, поле 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 и следующее сообщение об ошибке: "Недопустимая строка Base 64 для содержимого MIME".

Примеры

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

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

Запрос

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

POST https://graph.microsoft.com/beta/me/messages/AAMkADA1MTAAAH5JaKAAA=/replyAll
Content-Type: application/json

{
    "message":{
      "attachments": [
        {
          "@odata.type": "#microsoft.graph.fileAttachment",
          "name": "guidelines.txt",
          "contentBytes": "bWFjIGFuZCBjaGVlc2UgdG9kYXk="
        }
      ]
    },
    "comment": "Please take a look at the attached guidelines before you decide on the name."
}
Отклик

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

HTTP/1.1 202 Accepted

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

Запрос
POST https://graph.microsoft.com/beta/me/messages/AAMkADA1MTAAAH5JaLAAA=/replyAll
Content-Type: text/plain

RnJvbTogQWxleCBXaWxiZXIgPEFsZXhXQGNvbnRvc28uY29tPgpUbzogTWVnYW4gQm93ZW4gPE1l
Z2FuQkBjb250b3NvLmNvbT4KU3ViamVjdDogSW50ZXJuYWwgUmVzdW1lIFN1Ym1pc3Npb246IFNh
bGVzIEFzc29jaWF0ZQpUaHJlYWQtVG9waWM...
Отклик

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

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."
    }
}
  • Last updated on