outlookCategory-Ressourcentyp

Namespace: microsoft.graph

Stellt eine Kategorie dar, anhand der ein Benutzer Outlook-Elemente, z. B. Nachrichten und Ereignisse, gruppieren kann. Der Benutzer definiert Kategorien in einer Masterliste und kann eine oder mehrere dieser benutzerdefinierten Kategorien auf ein Element anwenden.

Mithilfe der REST-API können Sie Kategorien für einen Benutzer in der Masterliste erstellen und definieren. Sie können auch dieser Masterliste mit Kategorien erhalten, eine bestimmte Kategorie abrufen, aktualisieren die Farbe einer Kategorie, oder Löscheneine Kategorie. Sie können eine Kategorie auf ein Element anwenden, indem Sie die displayName-Eigenschaft der Kategorie der categories-Sammlung des Elements zuweisen. Zu den Ressourcen, denen Kategorien zugewiesen werden können, gehören Kontakt, Ereignis, Nachricht, Post und todoTask.

Jede Kategorie weist zwei Eigenschaften auf: displayName und color. Der Wert displayName muss in der Masterliste eines Benutzers eindeutig sein. Die color-Eigenschaft muss jedoch nicht eindeutig sein; mehrere Kategorien in der Masterliste können derselben Farbe zugeordnet werden. Sie können bis zu 25 verschiedene Farben Kategorien in der Masterliste eines Benutzers zuordnen.

Methoden

Eigenschaften

Hinweis Die möglichen Werte für color sind vordefinierte Konstanten wie None, preset0 und preset1. Jede voreingestellte Konstante ist weiter einer Farbe zugeordnet. Die tatsächliche Farbe ist von dem Outlook-Client abhängig, auf dem die Kategorien angezeigt werden. In der folgenden Tabelle sind die Farben dargestellt, die den einzelnen vordefinierten Konstanten für Outlook (Desktopclient) zugeordnet sind.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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