Microsoft Graph を使用したメールボックス管理

メッセージ、フォルダー、添付ファイルの操作に加えて、Aspose.Email for Java は、カテゴリ、Focused Inbox の Overrides、ルールなどのメールボックスレベルの機能も管理できます。また、リソースコンテキストを切り替えることで複数のメールボックスを操作できます。これらの操作は Graph API 統合を通じて利用可能です。

Outlook カテゴリの操作方法

Outlook のカテゴリは、メッセージをグループ化しラベル付けして整理しやすくします。Aspose.Email を使用すると、プログラムでカテゴリの作成、取得、更新、一覧表示、削除が可能です。

String categoryName = "Test Category";
int preset = CategoryPreset.Preset10;

// create a new category
OutlookCategory category = client.createCategory(categoryName, preset);

// fetch a category
OutlookCategory fetchedCategory = client.fetchCategory(category.getId());

// list categories
List<OutlookCategory> categories = client.listCategories();

// update a category
fetchedCategory.setDisplayName("Update Category");
fetchedCategory.setPreset(CategoryPreset.Preset11);
OutlookCategory updatedCategory = client.updateCategory(fetchedCategory);

// delete a category
client.delete(category.getId());

Overrides の操作方法

Overrides は、特定の送信者からのメッセージが Focused Inbox でどのように扱われるかを制御します。例えば、特定の送信者からのメッセージを常に Focused ビューに表示させることができます。

int focusedType = ClassificationType.Focused;

// create or update an override for a sender
ClassificationOverride override = client.createOrUpdateOverride(
    new MailAddress("testUser@host.com", "testUser"), focusedType
);

// list overrides
List<ClassificationOverride> list = client.listOverrides();
for (ClassificationOverride item : list)
    System.out.println(item.getSender().getAddress());

// update override classification
ClassificationOverride fetchedOverride = list.get(0);
fetchedOverride.setClassifyAs(ClassificationType.Other);
fetchedOverride.getSender().setDisplayName("testUser_1");
ClassificationOverride updatedOverride = client.createOrUpdateOverride(fetchedOverride);

// reset classification
fetchedOverride.setClassifyAs(ClassificationType.Focused);
updatedOverride = client.updateOverride(fetchedOverride);

// delete override
client.delete(updatedOverride.getId());

Outlook ルールの操作方法

メールボックスルールは、条件に基づくメッセージの転送やフィルタリングなどの自動化を可能にします。Graph API では、受信トレイルールの作成、取得、更新、一覧表示、削除ができます。

// create a new rule
InboxRule rule = new InboxRule();
rule.setDisplayName("Test rule");
rule.setPriority(1);
rule.setEnabled(true);
rule.setConditions(new RulePredicates());
rule.getConditions().containsSenderStrings(new StringCollection());
rule.getConditions().containsSenderStrings().addItem("testUser");

// define actions
rule.setActions(new RuleActions());
rule.getActions().setForwardToRecipients(new MailAddressCollection());
rule.getActions().getForwardToRecipients()
    .addMailAddress(new MailAddress("testUser@host.com", "testUser", true));
rule.getActions().setStopProcessingRules(true);

InboxRule createdRule = client.createRule(rule);

// list rules
List<InboxRule> listedRules = client.listRules();
for (InboxRule item : listedRules)
    System.out.println(item.getDisplayName());

// fetch and update a rule
InboxRule fetchedRule = client.fetchRule(createdRule.getRuleId());
createdRule.setDisplayName("Test rule 1");
createdRule.setEnabled(false);
InboxRule updatedRule = client.updateRule(createdRule);

// delete rule
client.delete(createdRule.getRuleId());

複数メールボックスの操作 - メールボックスコンテキストの切り替え

デフォルトでは、操作は現在のユーザーのメールボックスに対して実行されます。リソースタイプとリソースIDを設定することで、別のメールボックス（例: 共有メールボックスからメッセージを一覧）にコンテキストを切り替えることができます。

// switch to another mailbox
client.setResource(ResourceType.Users);
client.setResourceId("mailbox");
client.listMessages("mailfolder");

// switch back to the current user mailbox
client.setResource(ResourceType.Me);

Microsoft Graph での OData クエリ

Aspose.Email for Java は、Microsoft Graph を使用する際の OData クエリをサポートします。フォルダー、メッセージ、連絡先、カレンダーアイテムなどのリソース取得時に、高度なフィルタリング、並び替え、選択、ページング、展開が可能です。 ODataQueryBuilder このクラスは、クエリ文字列を手動で構築する代わりに、構造化かつ再利用可能な方法で OData クエリパラメータを構築できます。以下のメソッドは、大規模データセットのカウントや検索に適用できます:

Select 必要なプロパティだけを取得するために。
Filter フィルターを適用するために。
OrderBy 結果をソートするために。
Top および Skip ページング用。
Expand 単一クエリで関連エンティティを展開するために。

いくつかの GraphClient メソッドはオプションの ODataQueryBuilder OData クエリを適用するためのパラメータ、以下を含む:

listFolders
listMessages
listContacts
listCalendarItems
listAttachments
listCategories
listOverrides
listRules
listTaskLists
listTasks
listNotebooks

以下のコードサンプルは、次の使用方法を示します ODataQueryBuilder フォルダーをクエリし、詳細なフィルターとページングでメッセージを取得します:

IGraphClient client = GraphClient.GetClient();

client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

// Example 1: List folders ordered by name
ODataQueryBuilder builder = new ODataQueryBuilder();
builder.setOrderBy("name asc");

GraphFolderInfoCollection folders = client.listFolders(builder);
for (GraphFolderInfo folder : folders) {
    System.out.println(folder.getDisplayName());
}

String folderId = folders.get(0).getItemId();

// Example 2: Retrieve filtered and paged messages
builder = new ODataQueryBuilder();
{
    builder.setFilter("startswith(name,'A')");
    builder.setOrderBy("name asc");
    builder.setTop(10);
    builder.setSkip(5);
    builder.setSelect(new String[]{"name", "age"});
    builder.setExpand(new String[]{"children", "parents"});
    builder.setCount(true);
    builder.setSearch("\"John Doe\"");
    builder.setFormat("json");
};

GraphMessageInfoCollection msgs = client.listMessages(folderId, builder);
for (GraphMessageInfo msg : msgs) {
    System.out.println(msg.getSubject());
}

Microsoft Graph ユーティリティ機能