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,preset0undpreset1. 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"
}