mailFolder: importMime

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

下書き以外の メッセージを MIME コンテンツから直接 mailFolder に作成し、トランスポートに送信しません。

常に下書きが作成される メッセージの作成とは異なり、この操作では、最終的な非下書き状態でメッセージが作成されます。 メッセージは、配信されたかのように宛先フォルダーに表示されます。ただし、メールは伝送されず、送信済みとしてスタンプが押されることはなく、[ 送信済みアイテム ] フォルダーに表示されることはありません。 このアクションは、インターネット メッセージのヘッダー、本文部分、添付ファイルを含む完全な MIME コンテンツを保持します。

アクセス許可

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

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

HTTP 要求

POST /me/mailFolders/{mailFolderId}/importMime
POST /users/{usersId}/mailFolders/{mailFolderId}/importMime

メモ:{mailFolderId}には、フォルダー ID または既知のフォルダー名 (inbox など) を指定できます。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type text/plain. 必須です。

要求本文

要求本文で、メッセージの MIME コンテンツを入力します。 該当する インターネット メッセージ ヘッダー と MIME コンテンツを、すべて Base64 でエンコードします。

要求本文全体は Base64 でエンコードされた MIME コンテンツであり、JSON エンベロープやパラメーターは含まれません。 この API は、MIME プロパティを個別に編集または更新することをサポートしていません。

応答

成功した場合、このアクションは応答本文で 201 Created 応答コードと メッセージ オブジェクトを返します。 返されたメッセージでは、 isDraft が false に設定されています。

要求本文に不正な形式の MIME コンテンツが含まれている場合、このアクションは 400 Bad Request 応答コードと次のエラー メッセージを返します。 Invalid base64 string for MIME content.

例

要求

次の例は要求を示しています。 要求本文は、Base64 でエンコードされた MIME コンテンツで、読みやすくするために省略されています。

POST https://graph.microsoft.com/beta/me/mailFolders/inbox/importMime
Content-type: text/plain

RnJvbTogY29udG9zby1hbGVydHNAY29udG9zby5jb20NClRvOiB0ZXN0aW5nQGNvbnRvc28uY29t
DQpTdWJqZWN0OiBRdWFydGVybHkgcmVwb3J0DQpEYXRlOiBUaHUsIDI1IEp1biAyMDI2IDEwOjAw
OjAwIC0wNzAwDQpDb250ZW50LVR5cGU6IHRleHQvcGxhaW47IGNoYXJzZXQ9InV0Zi04Ig0KDQpC
b2R5IG9mIHRoZSBpbXBvcnRlZCBtZXNzYWdlLg==

応答

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

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

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('02d1914d-7abd-4621-a407-57b8bdeb1ada')/messages/$entity",
  "id": "AAMkADE5MWM0YmM5LThjOWUtNGFhZi1hOTBhLWNmZDBiZDhhNTljMABGAAAA",
  "createdDateTime": "2026-09-17T21:30:19Z",
  "lastModifiedDateTime": "2026-09-17T21:30:20Z",
  "receivedDateTime": "2026-09-17T21:30:20Z",
  "sentDateTime": "2026-07-24T20:03:00Z",
  "hasAttachments": false,
  "subject": "Quarterly report",
  "isRead": false,
  "isDraft": false,
  "parentFolderId": "AAMkADE5MWM0YmM5LThjOWUtNGFhZi1hOTBhLWNmZDBiZDhhNTljMAAuAAAA"
}
  • 最終更新: