メッセージ: replyAll
名前空間: microsoft.graph
JSON 形式または MIME 形式を使用して 、メッセージ のすべての受信者に返信します。
JSON 形式を使用する場合:
- パラメーターのコメントまたは body プロパティを
message
指定します。 両方を指定すると、「HTTP 400 要求が正しくありません」というエラーが返されます。 - 元のメッセージで replyTo プロパティに受信者が指定されている場合は、インターネット メッセージ形式 (RFC 2822) に従って、from プロパティの受信者ではなく、replyTo の受信者に返信を送信します。
MIME 形式を使用すると、以下のことが可能になります。
- 適用する インターネット メッセージ ヘッダー と MIME コンテンツを指定してから、要求本文に base64 形式でエンコードします。
- 任意の添付ファイルと S/MIME プロパティを 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 オブジェクトには application/json を、MIME コンテンツには text/plain を使用します。 |
優先: outlook.timezone | string | この API が要求本文に Sent 基づいて作成する HTML の応答メッセージのフィールドのタイム ゾーンを設定します。 値には、ユーザー用に構成 された supportedTimeZones のいずれかを指定できます。 指定しない場合、その Sent フィールドは UTC です。このヘッダーは、HTML で応答メッセージを Content-Type: application/json 作成するヘッダーを指定している場合にのみ使用します。 ヘッダーを使用する Content-Type: text/plain 場合、この Prefer ヘッダーには影響しません。 省略可能です。 |
要求本文
JSON 形式を使用する場合は、次のパラメーターを使用して、要求本文に JSON オブジェクトを指定します。
パラメーター | 型 | 説明 |
---|---|---|
comment | String | 含めるコメントです。 空の文字列にすることができます。 |
本文を MIME 形式で指定する場合は、該当するインターネット メッセージ ヘッダーを MIME コンテンツに指定します。すべて要求本文で base64 形式でエンコードされます。 このメソッドは、元のメッセージの送信者とすべての受信者を新しいメッセージの受信者として読み込みます。
応答
成功した場合、このメソッドは 202 Accepted
応答コードを返します。 応答本文では何も返されません。
要求本文に不正な MIME コンテンツが含まれていた場合、このメソッドは 400 Bad request
と次のエラー メッセージを返します。"MIME コンテンツの無効な base64 文字列"。
例
例 1: メッセージに対する JSON 形式の応答すべて
以下は、この API を呼び出す方法の例です。
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/v1.0/me/messages/{id}/replyAll
Content-type: application/json
{
"comment": "comment-value"
}
応答
次の例は応答を示しています。
HTTP/1.1 200 OK
例 2: MIME 形式でメッセージに返信する
要求
POST https://graph.microsoft.com/v1.0/me/messages/AAMkADA1MTAAAAqldOAAA=/replyAll
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."
}
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示