mailFolder リソースの種類

名前空間: microsoft.graph

受信トレイや下書きなどの、ユーザーのメールボックス内のメール フォルダーです。 メール フォルダーには、メッセージ、他の Outlook アイテム、子メール フォルダーを含めることができます。

このリソースは、デルタ関数を提供することによって、増分の追加、削除、および更新を追跡するためのデルタ クエリの使用をサポートしています。

既知のフォルダー名

Outlookは、デフォルトでユーザー用の特定のフォルダーを作成します。 対応するフォルダid値を使用する代わりに、便宜上、これらのフォルダにアクセスするときに、下の表にある既知のフォルダ名を使用できます。 たとえば、次のクエリで、よく知られている名前を使用して[下書き]フォルダを取得できます。

GET /me/mailFolders/drafts

既知の名前は、ユーザーのメールボックスのロケールに関係なく機能するため、上記のクエリでは、名前の付け方に関係なく、常にユーザーの Drafts フォルダーが返されます。

既知のフォルダー名 説明
アーカイブ アーカイブ フォルダーのメッセージは、対応する Outlook クライアントで One_Click アーカイブ機能を使用するときに送信されます。 注: これは、Exchange Online のメールボックスのアーカイブ機能と同じではありません。
低優先メール [Clutter]機能を使用すると、clutterフォルダに優先順位の低いメッセージがに移動されます。
競合 メールボックス内で競合するアイテムが含まれているフォルダ。
conversationhistory SkypeがIM会話を保存するフォルダ(Skypeがそうするように設定されている場合)。
deleteditems フォルダー項目は、削除されると に移動されます。
下書き 未送信メッセージが含まれているフォルダ。
inbox 受信トレイ フォルダー。
junkemail [迷惑メール] フォルダー。
localfailures ローカル クライアントに存在するが、サーバーにアップロードできなかった項目を含むフォルダー。
msgfolderroot "Top of Information Store" フォルダ。 このフォルダは、受信トレイなど、通常のメールクライアントに表示されるフォルダの親フォルダです。
送信トレイ 送信トレイ フォルダー。
recoverableitemsdeletions ソフト削除されたアイテムを含むフォルダ:[削除済みアイテム]フォルダから削除するか、OutlookでShift + Deleteキーを押して削除したアイテム。 このフォルダーはどの Outlook メール クライアントにも表示されませんが、エンド ユーザーは Outlook または Outlook on the web の [サーバーから削除済みアイテムを回復する] 機能を使用して操作できます。
スケジュール済み iOS用Outlookのスケジュール機能を使用して受信トレイに再表示されるようにスケジュールされているメッセージを含むフォルダ。
searchfolders ユーザーのメールボックスに定義されているすべての検索フォルダーの親フォルダー。
sentitems 送信済みアイテム フォルダー。
serverfailures サーバー上に存在するが、ローカル クライアントに同期できなかった項目を含むフォルダー。
syncissues Outlookによって作成された同期ログを含むフォルダー。

メソッド

メソッド 戻り値の型 説明
mailFolders を一覧表示する mailFolder コレクション 指定されたユーザーのメールボックス内にあるすべてのメール フォルダ (メール検索フォルダなど) を取得します。
mailFolder の取得 mailFolder mailFolder オブジェクトのプロパティとリレーションシップを読み取ります。
Create mailFolder mailFolder ユーザーのメールボックスのルート フォルダーに新しいメール フォルダーを作成します。
childFolders を一覧表示する MailFolder コレクション 指定したフォルダーの下のフォルダー コレクションを取得します。 ショートカットを使用すると、最上位フォルダーのコレクションを取得して、別のフォルダーに移動することができます。
childFolder の作成 mailFolder childFolders コレクションへの投稿により、現在の mailFolder 下に新しい mailFolder を作成します。
メッセージの作成 Message メッセージ コレクションへの投稿により、現在の mailFolder に新しいメッセージを作成します。
List messages Message コレクション サインインしているユーザーのメールボックス内のすべてのメッセージや、メールボックス内の指定したフォルダー内のメッセージを取得します。
更新する mailFolder 指定した mailFolder オブジェクトを更新します。
削除 なし 指定した mailFolder オブジェクトを削除します。
コピー MailFolder mailFolder とその内容を別の mailFolder にコピーします。
delta mailFolder コレクション ユーザーのメールボックスで追加または削除された一連のメール フォルダーを取得します。
move MailFolder mailFolder とその内容を別の mailFolder に移動します。
拡張プロパティ
単一値の拡張プロパティを作成する mailFolder 新規または既存の mailFolder に、1 つ以上の単一値の拡張プロパティを作成します。
単一値の拡張プロパティを持つ mailFolder の取得 mailFolder $expand または $filter を使用して、単一値の拡張プロパティを含む mailFolder を取得します。
複数値の拡張プロパティを作成する mailFolder 新規または既存の mailFolder の 1 つ以上の複数値の拡張プロパティを作成します。
複数値の拡張プロパティを持つ mailFolder の取得 mailFolder $expand を使用して、複数値の拡張プロパティを含む mailFolder を取得します。

プロパティ

プロパティ 説明
childFolderCount Int32 現在の mailFolder の直下の子 mailFolder の数。
displayName String mailFolder の表示名。
id 文字列 mailFolder の一意識別子。
IsHidden ブール値 mailFolder が非表示かどうかを示します。 このプロパティは、フォルダー作成時にのみ設定できます。 詳細については、「非表示メール フォルダ」でご確認ください。
parentFolderId String mailFolder の親 mailFolder の一意識別子。
totalItemCount Int32 mailFolder に含まれるアイテムの数
unreadItemCount Int32 mailFolder 内で未読としてマークされているアイテムの数。

アイテム数を効率的に取得する

フォルダーの TotalItemCountプロパティと UnreadItemCount プロパティを使用すると、ファイル内の既読アイテム数を簡単に算出できます。 大幅な待ち時間を招く可能性がある次のようなクエリを避けることができます。

https://graph.microsoft.com/v1.0/me/mailFolders/inbox/messages?$count=true&$filter=isread%20eq%20false

Outlook のメール フォルダーには複数の種類のアイテムを含めることができます。たとえば、受信トレイにはメール アイテムとは異なる会議出席依頼アイテムを含めることができます。 TotalItemCountUnreadItemCount には、アイテムの種類に関係なく、フォルダー内のアイテム全てが含まれます。

メール フォルダーを非表示にする

isHidden プロパティの既定値は、false です。 mailFolder を作成する場合に一度だけ isHidden を設定できます。 PATCH 操作を使用してプロパティを更新することはできません。 フォルダーの isHidden プロパティを変更するには、既存のフォルダーを削除して、望ましい値を持つ新しいフォルダーを作成します。

非表示メール フォルダーは、通常のメール フォルダーでサポートされたすべての操作をサポートします。

既定では、 mailFolders を一覧表示 すると、非表示になっていないメール フォルダーのみが返されます。 非表示のメール フォルダーを応答に含めるには、クエリ パラメーター includeHiddenFolders=true を使用します。 そして、isHidden プロパティを使用して、メール フォルダーが非表示であるかどうかを特定します。

リレーションシップ

リレーションシップ 説明
childFolders MailFolder コレクション mailFolder 内の子フォルダーのコレクション。
messageRules messageRule コレクション ユーザーの受信トレイ フォルダーに適用されるルールのコレクション。
messages Message コレクション mailFolder 内のメッセージのコレクション。
multiValueExtendedProperties multiValueLegacyExtendedProperty collection mailFolder に対して定義された、複数値の拡張プロパティのコレクション。 読み取り専用。 Null 許容型。
singleValueExtendedProperties singleValueLegacyExtendedProperty collection mailFolder に対して定義された、単一値の拡張プロパティのコレクションです。 読み取り専用。 Null 許容型。

JSON 表記

リソースの JSON 表現を次に示します。

{
  "childFolderCount": 1024,
  "displayName": "string",
  "id": "string (identifier)",
  "parentFolderId": "string",
  "totalItemCount": 1024,
  "unreadItemCount": 1024,
  "isHidden": false,
  "childFolders": [ { "@odata.type": "microsoft.graph.mailFolder" } ],
  "messageRules": [ { "@odata.type": "microsoft.graph.messageRule" } ],
  "messages": [ { "@odata.type": "microsoft.graph.message" } ],
  "multiValueExtendedProperties": [ { "@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty" }],
  "singleValueExtendedProperties": [ { "@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty" }]
}