outlookCategory リソースの種類

名前空間: microsoft.graph

ユーザーが Outlook アイテム (メッセージやイベントなど) をグループ化するために使用できるカテゴリを表します。 Outlook では、ユーザーはマスター リストでカテゴリを定義し、これらのユーザー定義カテゴリの 1 つ以上をアイテムに適用できます。

カテゴリを作成してユーザーのマスター カテゴリ リストに定義するには、REST API を使用することができます。 また、このマスター カテゴリ リストの取得、特定のカテゴリの取得、カテゴリに関連付けられている色の更新、カテゴリの削除などの操作を行うこともできます。 カテゴリをアイテムに適用するには、適用対象とするアイテムの categories コレクションに、カテゴリの displayName プロパティを割り当てます。 カテゴリを割り当てることができるリソースには、 連絡先、 イベント、 メッセージ、 outlookTask、 post、 todoTask などがあります。

各カテゴリは、 displayName と color という 2 つのプロパティによって属性付 けされます。 displayName の値は、ユーザーのマスター リスト内で一意でなければなりません。 ただし 、色 は一意である必要はありません。マスター リスト内の複数のカテゴリを同じ色にマップできます。 ユーザーのマスター リスト内のカテゴリには、最大 25 種類の色をマッピングできます。

メソッド

プロパティ

手記色に使用できる値は、None、preset0、preset1などのプリセット定数です。 各プリセット定数は、さらに色にマップされます。実際の色は、カテゴリが表示されている Outlook クライアントによって異なります。 次の表は、Outlook (デスクトップ クライアント) の各プリセット定数にマップされた色を示しています。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "color": "String",
  "displayName": "String"
}