メッセージ: 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."
    }
}