次の方法で共有


メッセージ: createReplyAll

名前空間: microsoft.graph

JSON 形式または MIME 形式で送信者と メッセージ のすべての受信者に返信する下書きを作成します。

JSON 形式を使用する場合:

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

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

下書きメッセージを以降の操作で送信します。

または、1 つのアクションで メッセージにすべて応答 します。

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

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

アクセス許可

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

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

HTTP 要求

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

要求ヘッダー

名前 説明
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 ヘッダーには影響しません。 省略可能です。

要求本文

このメソッドでは、要求本文は必要ありません。

ただし、MIME 形式を使用して replyAll draft を作成する場合は、該当するインターネット メッセージ ヘッダー (すべて要求本文の base64 形式でエンコード) を MIME コンテンツに指定します。

応答

成功した場合、このメソッドは 201 Created 応答コードと、応答本文で Message オブジェクトを返します。

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

例 1: 既存のメッセージにすべて返信する JSON 形式のメッセージ ドラフトを作成する

以下は、この API を呼び出す方法の例です。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/me/messages/{id}/createReplyAll
応答

次の例は応答を示しています。 注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-type: application/json

{
  "receivedDateTime": "datetime-value",
  "sentDateTime": "datetime-value",
  "hasAttachments": true,
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "bodyPreview": "bodyPreview-value"
}

例 2: 既存のメッセージに返信する MIME 形式のメッセージ ドラフトを作成する

要求
POST https://graph.microsoft.com/v1.0/me/messages/AAMkADA1MTAAAH5JaLAAA=/createReplyAll
Content-type: text/plain

Q29udGVudC1UeXBlOiBhcHBsaWNhdGlvbi9wa2NzNy1taW1lOw0KCW5hbWU9c21pbWUucDdtOw0KCXNtaW1lLXR5cGU9ZW52ZWxvcGVkLWRhdGENCk1pbWUtVmVyc2lvbjogMS4wIChNYWMgT1MgWCBNYWlsIDEzLjAgXCgzNjAxLjAuMTBcKSkNClN1YmplY3Q6IFJlOiBUZXN0aW5nIFMvTUlNRQ0KQ29udGVudC1EaXNwb3Np
応答

次の例は応答を示しています。

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('0aaa0aa0-0000-0a00-a00a-0000009000a0')/messages/$entity",
    "@odata.etag": "W/\"AAAAAAAAAAAa00AAAa0aAaAa0a0AAAaAAAAaAa0a\"",
    "id": "AAMkADA1MTAAAAqldOAAA=",
    "createdDateTime": "2021-04-23T18:13:44Z",
    "lastModifiedDateTime": "2021-04-23T18:13:44Z",
    "changeKey": "AAAAAAAAAAAA00aaaa000aaA",
    "categories": [],
    "receivedDateTime": "2021-04-23T18:13:44Z",
    "sentDateTime": "2021-02-28T07:15:00Z",
    "hasAttachments": false,
    "internetMessageId": "<AAAAAAAAAA@AAAAAAA0001AA0000.codcod00.prod.outlook.com>",
    "subject": "Internal Resume Submission: Sales Associate",
    "bodyPreview": "Hi, Megan.I have an interest in the Sales Associate position. Please consider my resume, which you can access here...",
    "importance": "normal",
    "parentFolderId": "LKJDSKJHkjhfakKJHFKWKKJHKJdhkjHDK==",
    "conversationId": "SDSFSmFSDGI5LWZhYjc4fsdfsd=",
    "conversationIndex": "Adfsdfsdfsdfw==",
    "isDeliveryReceiptRequested": null,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": true,
    "webLink": "https://outlook.office365.com/owa/?ItemID=AAMkAGNhOWAvsurl=1&viewmodel=ReadMessageItem",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "text",
        "content": "Hi, Megan.I have an interest in the Sales Associate position. Please consider my resume, which you can access here... Regards,Alex"
    },
    "sender": {
        "emailAddress": {
            "name": "Alex Wilber",
            "address": "AlexW@contoso.com"
        }
    },
    "from": {
        "emailAddress": {
            "name": "Alex Wilber",
            "address": "AlexW@contoso.com"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "Megan Bowen",
                "address": "MeganB@contoso.com"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "flag": {
        "flagStatus": "notFlagged"
    }
}

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

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

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