メッセージ: replyAll

  • [アーティクル]

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

JSON 形式または MIME 形式を使用して 、メッセージ のすべての受信者に返信します。

JSON 形式を使用する場合:

  • パラメーターのコメントまたは body プロパティを message 指定します。 両方を指定すると、「HTTP 400 要求が正しくありません」というエラーが返されます。
  • 元のメッセージで replyTo プロパティに受信者が指定されている場合は、インターネット メッセージ形式 (RFC 2822) に従って、from プロパティの受信者ではなく、replyTo の受信者に返信を送信します。

MIME 形式を使用すると、以下のことが可能になります。

このメソッドでは、[送信済みアイテム] フォルダーにメッセージを保存できます。

または、 メッセージに返信する下書きを作成し、後で 送信 します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ✅

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Mail.Send 注意事項なし。
委任 (個人用 Microsoft アカウント) Mail.Send 注意事項なし。
アプリケーション Mail.Send 注意事項なし。

HTTP 要求

POST /users/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 ベアラー {token}。 必須
Content-Type string エンティティ本文内のデータの性質です。 必須
JSON オブジェクトと text/plain MIME コンテンツに使用application/jsonする
優先: outlook.timezone string この API が要求本文に Sent 基づいて作成する HTML の応答メッセージのフィールドのタイム ゾーンを設定します。 値には、ユーザー用に構成 された supportedTimeZones のいずれかを指定できます。 指定しない場合、その Sent フィールドは UTC です。

このヘッダーは、HTML で応答メッセージを Content-Type: application/json 作成するヘッダーを指定している場合にのみ使用します。 ヘッダーを使用する Content-Type: text/plain 場合、この Prefer ヘッダーには影響しません。 省略可能です。

要求本文

JSON オブジェクトを使用する場合、次のパラメーターを含む JSON オブジェクトを指定します。

パラメーター 型 説明
comment String 含めるコメントです。 空の文字列にすることができます。
message message 返信メッセージで更新する書き込み可能なプロパティです。

本文を MIME 形式で指定する場合は、該当するインターネット メッセージ ヘッダーを MIME コンテンツに指定します。すべて要求本文で base64 形式でエンコードされます。 このメソッドは、元のメッセージの送信者とすべての受信者を新しいメッセージの受信者として読み込みます。

応答

成功した場合、このメソッドは 202 Accepted 応答コードを返します。 応答本文では何も返されません。

要求本文に不正な MIME コンテンツが含まれていた場合、このメソッドは 400 Bad request と次のエラー メッセージを返します。"MIME コンテンツの無効な base64 文字列"。

例

例 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."
    }
}