メッセージ: reply

名前空間: microsoft.graph

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

JSON 形式を使用する場合:

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

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

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

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

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

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

アクセス許可

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

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

HTTP 要求

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

要求ヘッダー

名前 説明
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 含めるコメントです。 空の文字列にすることができます。
message message 返信メッセージで更新する書き込み可能なプロパティです。

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

応答

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

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

例 1: 既存のメッセージに JSON 形式で応答する

次の例では、コメントを含め、受信者を返信メッセージに追加します。

要求

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

POST https://graph.microsoft.com/v1.0/me/messages/AAMkADA1MTAAAAqldOAAA=/reply
Content-Type: application/json

{
  "message":{
    "toRecipients":[
      {
        "emailAddress": {
          "address":"samanthab@contoso.com",
          "name":"Samantha Booth"
        }
      },
      {
        "emailAddress":{
          "address":"randiw@contoso.com",
          "name":"Randi Welch"
        }
      }
     ]
  },
  "comment": "Samantha, Randi, would you name the group please?"
}

応答

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

HTTP/1.1 202 Accepted

例 2: MIME 形式で既存のメッセージに返信する

要求

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

POST https://graph.microsoft.com/v1.0/me/messages/AAMkADA1MTAAAAqldOAAA=/reply
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."
    }
}