次の方法で共有


メッセージ: forward

名前空間: microsoft.graph

JSON 形式または MIME 形式を使用してメッセージを転送します。

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

  • パラメーターのコメントまたは body プロパティを message 指定します。 両方を指定すると、「HTTP 400 要求が正しくありません」というエラーが返されます。
  • パラメーターまたはパラメーターの toRecipientstoRecipients プロパティを message 指定します。 両方を指定するか、どちらも指定しないと、「HTTP 400 要求が正しくありません」というエラーが返されます。

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

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

または、 下書きを作成してメッセージを転送し、後で 送信 します。

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

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

アクセス許可

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

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

HTTP 要求

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

要求ヘッダー

名前 説明
Authorization string ベアラー {token}。 必須
Content-Type string エンティティ本文内のデータの性質です。 必須です。
JSON オブジェクトには application/json を、MIME コンテンツには text/plain を使用します。

要求本文

JSON 形式を使用する場合は、次のパラメーターを使用して、要求本文に JSON オブジェクトを指定します。

パラメーター 説明
comment String 含めるコメントです。 空の文字列にすることができます。
toRecipients Recipient collection 受信者の一覧です。

MIME 形式で本文を指定する場合は、適用するインターネット メッセージ ヘッダー") を含む MIME コンテンツを、要求本文に base64 形式ですべてエンコードして指定します。

応答

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

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

例 1: JSON 形式を使用してメッセージを転送する

この API を呼び出す方法の例を次に示します。

要求

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

POST https://graph.microsoft.com/v1.0/me/messages/{id}/forward
Content-type: application/json

{
  "comment": "comment-value",
  "toRecipients": [
    {
      "emailAddress": {
        "name": "name-value",
        "address": "address-value"
      }
    }
  ]
}
応答

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

HTTP/1.1 202 Accepted

例 2: MIME コンテンツを使用してメッセージを転送する

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