Übersicht über erweiterte Outlook-EigenschaftenOutlook extended properties overview

Erweiterte Eigenschaften ermöglichen das Speichern von benutzerdefinierten Daten und dienen insbesondere als Fallbackmechanismus, mit dem Apps auf benutzerdefinierte Daten für Outlook-MAPI-Eigenschaften zugreifen können, wenn diese Eigenschaften noch nicht in den Microsoft Graph-API-Metadaten verfügbar gemacht wurden. Sie können die REST-API für erweiterte Eigenschaften verwenden, um diese benutzerdefinierten Daten in folgenden Benutzerressourcen zu speichern oder abzurufen:Extended properties allow storing custom data and specifically serve as a fallback mechanism for apps to access custom data for Outlook MAPI properties when these properties are not already exposed in the Microsoft Graph API metadata. You can use extended properties REST API to store or get such custom data in the following user resources:

Möglich sind auch die folgenden Office 365-Gruppenressourcen:Or, in the following Office 365 group resources:

Sollten erweiterte Eigenschaften oder offene Erweiterungen verwendet werden?Use extended properties or open extensions?

In den meisten üblichen Szenarios sollten offene Erweiterungen verwendet werden können (dargestellt durch openTypeExtension und bisher als Office 365-Datenerweiterungen bezeichnet), um benutzerdefinierte Daten für Ressourceninstanzen im Postfach eines Benutzers zu speichern oder darauf zuzugreifen. Verwenden Sie erweiterte Eigenschaften nur, wenn Sie auf benutzerdefinierte Daten für Outlook-MAPI-Eigenschaften zugreifen müssen, die nicht bereits in den Microsoft Graph-API-Metadaten verfügbar gemacht wurden.In most common scenarios, you should be able to use open extensions (represented by openTypeExtension, formerly known as Office 365 data extensions) to store and access custom data for resource instances in a user's mailbox. Use extended properties only if you need to access custom data for Outlook MAPI properties that are not already exposed in the Microsoft Graph API metadata.

Typen erweiterter EigenschaftenTypes of extended properties

Je nachdem, ob Sie einen einzelnen oder mehrere Werte (vom gleichen Typ) in einer erweiterten Eigenschaft speichern möchten, können Sie eine erweiterte Eigenschaft als SingleValueLegacyExtendedProperty oder als MultiValueLegacyExtendedProperty erstellen.Depending on whether you intend to store a single or multiple values (of the same type) in an extended property, you can create an extended property as a singleValueLegacyExtendedProperty, or multiValueLegacyExtendedProperty.

Jeder dieser Typen identifiziert die Eigenschaft nach ihrer ID und speichert Daten als Wert.Each of these types identifies the property by its id and stores data in value.

Sie können die ID verwenden, um eine spezifische Ressourceninstanz zusammen mit der erweiterten Eigenschaft abzurufen, oder sie können nach einer einwertigen erweiterten Eigenschaft filtern, um alle Instanzen mit dieser Eigenschaft abzurufen.You can use id to get a specific resource instance together with that extended property, or filter on a single-value extended property to get all the instances that have that property.

Hinweis Sie können die REST API nicht dafür verwenden, alle erweiterten Eigenschaften einer spezifischen Instanz in einem Aufruf abzurufen.Note You cannot use the REST API to get all the extended properties of a specific instance in one call.

ID-Formateid formats

Sie können in drei Formaten Id einer erweiterten Eigenschaft angeben:You can specify id of an extended property in one of three formats:

  • Als eine benannte Eigenschaft, durch die erweiterte Eigenschaftentyp, Namespace und eines Zeichenfolgennamens identifiziert.As a named property, identified by the extended property type, namespace, and a string name.
  • Als eine benannte Eigenschaft, durch die erweiterte Eigenschaftentyp, Namespace und einen numerischen Bezeichner identifiziert.As a named property, identified by the extended property type, namespace, and a numeric identifier.
  • Format Proptag, identifiziert den Typ der erweiterten Eigenschaft sowie ein MAPI-Eigenschaftentag.In a proptag format, identified by the extended property type and a MAPI property tag.

Die nächsten 2 Tabellen beschreiben diese Formate als erweiterte Eigenschaften auf einzelne und mit mehreren Werten angewendet.The next 2 tables describe these formats as applied to single and multi-value extended properties. {Typ} stellt den Typ des den oder die Werte der erweiterten Eigenschaft dar.{type} represents the type of the value or values of the extended property. In den Beispielen sind dies Zeichenfolgen, ganze Zahlen und Arrays dieser Typen.Shown in the examples are string, integer, and arrays of these types.

Gültige ID-Formate für einwertige erweiterte EigenschaftenValid id formats for single-value extended properties

FormatFormat BeispielExample BeschreibungDescription
„{type} {guid} Name {name}“"{type} {guid} Name {name}" "String {8ECCC264-6880-4EBE-992F-8888D2EEAA1D} Name TestProperty" Identifiziert eine Eigenschaft, indem Sie den Namespace (die GUID), zu der sie gehört, und eines Zeichenfolgennamens.Identifies a property by the namespace (the GUID) it belongs to, and a string name.
„{type} {guid} Id {id}“"{type} {guid} Id {id}" "Integer {8ECCC264-6880-4EBE-992F-8888D2EEAA1D} Id 0x8012" Identifiziert eine Eigenschaft durch den Namespace (die GUID), zu der sie gehört, und einen numerischen Bezeichner.Identifies a property by the namespace (the GUID) it belongs to, and a numeric identifier.
"{Typ} {Proptag}""{type} {proptag}" "String 0x4001001E" Identifiziert eine vordefinierte Eigenschaft von der Eigenschaftentag.Identifies a pre-defined property by its property tag.

Gültige ID-Formate für mehrwertige erweiterte EigenschaftenValid id formats for multi-value extended properties

FormatFormat BeispielExample BeschreibungDescription
„{type} {guid} Name {name}“"{type} {guid} Name {name}" "StringArray {8ECCC264-6880-4EBE-992F-8888D2EEAA1D} Name TestProperty" Identifiziert eine Eigenschaft durch den Namespace (die GUID) und eines Zeichenfolgennamens.Identifies a property by the namespace (the GUID) and a string name.
„{type} {guid} Id {id}“"{type} {guid} Id {id}" "IntegerArray {8ECCC264-6880-4EBE-992F-8888D2EEAA1D} Id 0x8013" Identifiziert eine Eigenschaft durch den Namespace (die GUID) und einen numerischen Bezeichner.Identifies a property by the namespace (the GUID) and a numeric identifier.
"{Typ} {Proptag}""{type} {proptag}" "StringArray 0x4002101E" Identifiziert eine vordefinierte Eigenschaft von der Eigenschaftentag.Identifies a pre-defined property by its property tag.

Verwenden Sie eines der Formate für die benannte Eigenschaft, um eine erweiterte Eigenschaft einwertig oder mit mehreren Werten als benutzerdefinierte Eigenschaft zu definieren.Use either of the named property formats to define a single-value or multi-value extended property as a custom property. Zwischen den beiden Formaten ist das erste aus, das eine Zeichenfolge (Name) übernimmt das bevorzugte Format Bezug zu erleichtern.Among the two formats, the first one that takes a string name (Name) is the preferred format for ease of reference. Benannte Eigenschaften verfügen über ihre Eigenschaftenbezeichner in der 0 x 8000-0xfffe Bereich.Named properties have their property identifiers in the 0x8000-0xfffe range.

Verwenden Sie das Format Proptag Zugriff auf Eigenschaften, die vordefinierte MAPI oder von einem Client oder Server, und, haben nicht bereits verfügbar gemacht wurde in Microsoft Graph.Use the proptag format to access properties predefined by MAPI, or by a client or server, and that have not already been exposed in Microsoft Graph. Diese Eigenschaften haben Eigenschaftenbezeichner in der 0 x 0001-0x7fff Bereich.These properties have property identifiers in the 0x0001-0x7fff range. Versuchen Sie nicht, um eine benutzerdefinierte Eigenschaft mit dem Format Proptag zu definieren.Do not try to define a custom property using the proptag format.

Informationen zum Zuordnen einer erweiterten Eigenschaft zu einer vorhandenen MAPI-Eigenschaft wie dem Eigenschaftsbezeichner und der GUID finden Sie unter [MS-OXPROPS] Microsoft Corporation, „Eigenschaften für Exchange Server-Protokolle“.You can find information about mapping an extended property to an existing MAPI property, such as the property identifier and GUID, in [MS-OXPROPS] Microsoft Corporation, "Exchange Server Protocols Master Property List".

Hinweis Nachdem Sie ein Format für die ID ausgewählt haben, sollten Sie nur mit diesem Format auf die betreffende erweiterte Eigenschaft zugreifen.Note After you have chosen one format for the id, you should access that extended property by only that format.

REST-API-VorgängeREST API operations

Vorgänge für erweiterte Eigenschaften mit einem einzelnen Wert:Single-value extended property operations:

Vorgänge für erweiterte Eigenschaften mit mehreren Werten:Multi-value extended property operations: