outlookCategory-RessourcentypoutlookCategory resource type

Stellt eine Kategorie dar, anhand der ein Benutzer Outlook-Elemente, z. B. Nachrichten und Ereignisse, gruppieren kann.Represents a category by which a user can group Outlook items such as messages and events. Der Benutzer definiert Kategorien in einer Masterliste und kann eine oder mehrere dieser benutzerdefinierten Kategorien auf ein Element anwenden.The user defines categories in a master list, and can apply one or more of these user-defined categories to an item.

Mithilfe der REST-API können Sie Kategorien für einen Benutzer in der Masterliste erstellen und definieren.Using the REST API, you can create and define categories in the master list of categories for a user. Sie können auch dieser Masterliste mit Kategorien erhalten, eine bestimmte Kategorie abrufen, aktualisieren die Farbe einer Kategorie, oder Löscheneine Kategorie.You can also get this master list of categories, get a specific category, update the color associated with a category, or delete a category. Sie können eine Kategorie auf ein Element anwenden, indem Sie die displayName-Eigenschaft der Kategorie der categories-Sammlung des Elements zuweisen.You can apply a category to an item by assigning the displayName property of the category to the categories collection of the item. Ressourcen, die Kategorien zugewiesen werden können, sind contact, event, message und post.Resources that can be assigned categories include contact, event, message, and post.

Jede Kategorie weist zwei Eigenschaften auf: displayName und color.Each category is attributed by 2 properties: displayName and color. Der Wert displayName muss in der Masterliste eines Benutzers eindeutig sein.The displayName value must be unique in a user's master list. Die color-Eigenschaft muss jedoch nicht eindeutig sein; mehrere Kategorien in der Masterliste können derselben Farbe zugeordnet werden.The color however does not have to be unique; multiple categories in the master list can be mapped to the same color. Sie können bis zu 25 verschiedene Farben Kategorien in der Masterliste eines Benutzers zuordnen.You can map up to 25 different colors to categories in a user's master list.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
displayNamedisplayName StringString Ein eindeutiger Name, der eine Kategorie im Postfach des Benutzers identifiziert.A unique name that identifies a category in the user's mailbox. Nach der Erstellung einer Kategorie kann der Namen nicht geändert werden.After a category is created, the name cannot be changed. Schreibgeschützt.Read-only.
colorcolor categoryColorcategoryColor Eine voreingestellte Konstante, die eine Kategorie charakterisiert und einer von 25 vordefinierten Farben zugeordnet ist.A pre-set color constant that characterizes a category, and that is mapped to one of 25 predefined colors. Siehe folgenden Hinweis.See the note below.

Hinweis Die möglichen Werte für color sind vordefinierte Konstanten wie None, preset0 und preset1.Note The possible values for color are pre-set constants such as None, preset0 and 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.Each pre-set constant is further mapped to a color; the actual color is dependent on the Outlook client that the categories are being displayed in. In der folgenden Tabelle sind die Farben dargestellt, die den einzelnen vordefinierten Konstanten für Outlook (Desktopclient) zugeordnet sind.The following table shows the colors mapped to each pre-set constant for Outlook (desktop client).

Voreingestellte KonstantePre-set constant In Outlook zugeordnete FarbeColor mapped to in Outlook
KeineNone Keine Farbe zugeordnetNo color mapped
Preset0Preset0 RedRed
Preset1Preset1 OrangeOrange
Preset2Preset2 BrownBrown
Preset3Preset3 YellowYellow
Preset4Preset4 GreenGreen
Preset5Preset5 TealTeal
Preset6Preset6 OliveOlive
Preset7Preset7 BlauBlue
Preset8Preset8 PurplePurple
Preset9Preset9 CranberryCranberry
Preset10Preset10 SteelSteel
Preset11Preset11 DarkSteelDarkSteel
Preset12Preset12 GrayGray
Preset13Preset13 DarkGrayDarkGray
Preset14Preset14 BlackBlack
Preset15Preset15 DarkRedDarkRed
Preset16Preset16 DarkOrangeDarkOrange
Preset17Preset17 DarkBrownDarkBrown
Preset18Preset18 DarkYellowDarkYellow
Preset19Preset19 DarkGreenDarkGreen
Preset20Preset20 DarkTealDarkTeal
Preset21Preset21 DarkOliveDarkOlive
Preset22Preset22 DarkBlueDarkBlue
Preset23Preset23 DarkPurpleDarkPurple
Preset24Preset24 DarkCranberryDarkCranberry

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.

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

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Kategorien auflistenList categories outlookCategory-SammlungoutlookCategory collection Ruft alle Kategorien ab, die für den Benutzer definiert wurden.Get all the categories that have been defined for the user.
Kategorie abrufenGet category outlookCategoryoutlookCategory Dient zum Abrufen der Eigenschaften und Beziehungen des angegebenen outlookCategory-Objekts.Get the properties and relationships of the specified outlookCategory object.
ErstellenCreate outlookCategoryoutlookCategory Erstellen eines outlookCategory-Objekts in der Masterliste von Kategorien.Create an outlookCategory object in the user's master list of categories.
AktualisierenUpdate outlookCategoryoutlookCategory Aktualisieren Sie die schreibbare Eigenschaft, color, des angegebenen outlookCategory-Objekts.Update the writable property, color, of the specified outlookCategory object.
DeleteDelete KeineNone Löscht das angegebene outlookCategory-Objekt.Delete the specified outlookCategory object.