メッセージ: replymessage: reply

名前空間: microsoft.graphNamespace: microsoft.graph

1 回の reply 呼び出しでメッセージ送信者に返信、コメントを追加、または更新可能なプロパティを変更します。その後、メッセージは [送信済みアイテム] フォルダーに保存されます。Reply to the sender of a message, add a comment or modify any updateable properties all in one reply call. The message is then saved in the Sent Items folder.

または、最初に下書きの返信メッセージを作成してコメントを含めるか、メッセージのプロパティを更新し、返信を送信します。Alternatively, you can first create a draft reply message to include a comment or update any message properties, and then send the reply.

Note

  • パラメーターには、comment または body プロパティのいずれかを指定できます。 body messageYou can specify either a comment or the body property of the message parameter. 両方を指定すると、「HTTP 400 要求が正しくありません」というエラーが返されます。Specifying both will return an HTTP 400 Bad Request error.
  • 元のメッセージでreplytoプロパティが指定されている場合、インターネットメッセージ形式 (RFC 2822) ごとに、 fromプロパティで受信者ではなく、 replytoの受信者に返信を送信する必要があります。If the replyTo property is specified in the original message, per Internet Message Format (RFC 2822), you should send the reply to the recipients in replyTo and not the recipient in the from property.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Mail.SendMail.Send
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) Mail.SendMail.Send
アプリケーションApplication Mail.SendMail.Send

HTTP 要求HTTP request

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

要求ヘッダーRequest headers

名前Name Type 説明Description
AuthorizationAuthorization stringstring ベアラー {トークン}。必須。Bearer {token}. Required.
Content-TypeContent-Type stringstring エンティティ本文内のデータの性質です。必須。Nature of the data in the body of an entity. Required.

要求本文Request body

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。In the request body, provide a JSON object with the following parameters.

パラメーターParameter Type 説明Description
commentcomment StringString 含めるコメントです。空の文字列にすることができます。A comment to include. Can be an empty string.
messagemessage messagemessage 返信メッセージで更新する書き込み可能なプロパティです。Any writeable properties to update in the reply message.

応答Response

成功した場合、このメソッドは 202 Accepted 応答コードを返します。応答本文には何も返されません。If successful, this method returns 202 Accepted response code. It does not return anything in the response body.

Example

次の例では、コメントを含め、受信者を返信メッセージに追加します。The following example includes a comment and adds a recipient to the reply message.

要求Request

以下は、要求の例です。Here is an example of the request.

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

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

以下は、応答の例です。Here is an example of the response.

HTTP/1.1 202 Accepted