Teilen über


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

Methode Rückgabetyp Beschreibung
Kategorien auflisten outlookCategory-Sammlung Ruft alle Kategorien ab, die für den Benutzer definiert wurden.
Kategorie abrufen outlookCategory Dient zum Abrufen der Eigenschaften und Beziehungen des angegebenen outlookCategory-Objekts.
Kategorie erstellen outlookCategory Erstellen eines outlookCategory-Objekts in der Masterliste von Kategorien.
Kategorie aktualisieren outlookCategory Aktualisieren Sie die schreibbare Eigenschaft, color, des angegebenen outlookCategory-Objekts.
Kategorie löschen Keine Löscht das angegebene outlookCategory-Objekt.

Eigenschaften

Eigenschaft Typ Beschreibung
color categoryColor Eine voreingestellte Konstante, die eine Kategorie charakterisiert und einer von 25 vordefinierten Farben zugeordnet ist. Weitere Informationen finden Sie im folgenden Hinweis.
displayName Zeichenfolge Ein eindeutiger Name, der eine Kategorie im Postfach des Benutzers identifiziert. Nach der Erstellung einer Kategorie kann der Namen nicht geändert werden. Schreibgeschützt.

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.

Voreingestellte Konstante In Outlook zugeordnete Farbe
Keine Keine Farbe zugeordnet
Preset0 Red
Preset1 Orange
Preset2 Brown
Preset3 Yellow
Preset4 Green
Preset5 Teal
Preset6 Olive
Preset7 Blau
Preset8 Purple
Preset9 Cranberry
Preset10 Steel
Preset11 DarkSteel
Preset12 Gray
Preset13 DarkGray
Preset14 Black
Preset15 DarkRed
Preset16 DarkOrange
Preset17 DarkBrown
Preset18 DarkYellow
Preset19 DarkGreen
Preset20 DarkTeal
Preset21 DarkOlive
Preset22 DarkBlue
Preset23 DarkPurple
Preset24 DarkCranberry

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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