openTypeExtension-Ressourcentyp (offene Erweiterungen)openTypeExtension resource type (open extensions)

Open-Erweiterungen (vormals Office 365 Daten Extensions) bieten eine einfache Möglichkeit nicht typisierte Eigenschaften auf eine Ressource in Microsoft Graph direkt hinzufügen.Open extensions (formerly known as Office 365 data extensions) provide an easy way to directly add untyped properties to a resource in Microsoft Graph.

Offiene Erweiterungen werden mithilfe der openTypeExtension-Ressource dargestellt.Open extensions are represented by the openTypeExtension resource. Alle offenen Erweiterungen, die einer Ressource hinzugefügt wurden, werden in der extensions-Navigationseigenschaft angezeigt, die vom abstrakten Typ extension abgeleitet wird.Any open extension added to a resource shows up in the extensions navigation property, which is derived from the extension abstract type. Jede Erweiterung weist eine extensionName-Eigenschaft auf, die die einzige vordefinierte, schreibbare Eigenschaft für alle Erweiterungen zusammen mit ihren benutzerdefinierten Daten ist.Each extension has an extensionName property which is the only pre-defined, writable property for all extensions, along with your custom data.

Um sicherzustellen, dass Erweiterungsnamen eindeutig sind, können Sie eine umgekehrtes DNS-Format (Domain Name System) verwenden, das von Ihrer eigenen Domäne, z. B. Com.Contoso.ContactInfo, abhängig ist.One way to help make sure extension names are unique is to use a reverse domain name system (DNS) format that is dependent on your own domain, for example, Com.Contoso.ContactInfo. Verwenden Sie in Erweiterungsnamen auf keinen Fall die Microsoft-Domäne (Com.Microsoft oder Com.OnMicrosoft).Do not use the Microsoft domain (Com.Microsoft or Com.OnMicrosoft) in an extension name.

Beispiel für eine offene Erweiterung: Hinzufügen von benutzerdefinierten Daten zu Benutzern mithilfe offener ErweiterungenOpen extension example: Add custom data to users using open extensions

Offene Erweiterungen werden von den folgenden Ressourcen in den entsprechenden Versionen unterstützt: - Allgemein verfügbar (GA: /v1.0 und /beta) oder Vorschau (/beta).Open extensions are supported by the following resources in the corresponding versions - general availability (GA: /v1.0 and /beta) or preview (/beta).

RessourceResource VersionVersion
Administrative EinheitAdministrative unit Nur VorschauPreview only
KalenderereignisCalendar event Allgemein verfügbarGA
Kalenderereignis für GruppeGroup calendar event Allgemein verfügbarGA
Unterhaltungsthread der Gruppe postenGroup conversation thread post Allgemein verfügbarGA
devicedevice Allgemein verfügbarGA
groupgroup Allgemein verfügbarGA
messagemessage Allgemein verfügbarGA
organizationorganization Allgemein verfügbarGA
Privater KontaktPersonal contact Allgemein verfügbarGA
useruser Allgemein verfügbarGA

Outlook-spezifische AspekteOutlook-specific considerations

Jede open Erweiterung auf einer Outlook-Ressource (Ereignis, Nachricht oder persönlichen Kontakt) vorhanden ist in einem MAPI benannte Eigenschaftgespeichert.Each open extension present on an Outlook resource (event, message, or personal contact) is stored in a MAPI named property. Berücksichtigen Sie beim Erstellen von open-Erweiterungen für Outlook, dass MAPI benannte Eigenschaften sind eine begrenzte Ressource im Postfach des Benutzers.When you create open extensions for Outlook, consider that MAPI named properties are a finite resource in a user's mailbox. Wenn ein Benutzer benannte Eigenschaft Quota leer ist, können nicht Sie keine mehr benannten Eigenschaften für diesen Benutzer erstellen.When a user's named property quota is exhausted, you can't create any more named properties for that user. Dies kann unerwartetes Verhalten von Clients führen, die benannte Eigenschaften-Funktion verwenden.This can result in unexpected behavior from clients that rely on named properties to function.

Wenden Sie die folgenden Richtlinien beim Erstellen von open-Erweiterungen für Outlook-Ressourcen:Apply the following guidelines when you create open extensions on Outlook resources:

  • Erstellen Sie die minimale Anzahl von Erweiterungen erforderlich.Create the minimum number of extensions required. Die meisten Clientanwendungen sollten nicht mehr als eine Erweiterung erfordern.Most applications should require no more than one extension. Erweiterungen haben keine Eigenschaften festgelegt wird, oder die Struktur, damit Sie mehrere Werte in einer Erweiterung speichern können.Extensions have no set defined properties or structure, so you can store multiple values in a single extension.
  • Benennen Sie Erweiterungen in einer Variablen Weise (z. B. basierend auf Benutzereingaben usw..).Avoid naming extensions in a variable manner (such as based on user input, etc.). Jedes Mal, wenn eine open Erweiterung mit einem neuen Namen erstellt wird, die nicht im Postfach eines Benutzers vor, verwendet wurde, wird ein neues MAPI benannte Eigenschaft erstellt.Each time an open extension is created with a new name that has not been used in a user's mailbox before, a new MAPI named property is created. Entfernen die Erweiterung, die benannte Eigenschaft nicht entfernt.Removing the extension does not remove the named property.

Verwenden Sie open-Erweiterungen (für Outlook-Ressourcen) oder erweiterten EigenschaftenUse open extensions (for Outlook resources) or extended properties

Open Extensions sind die empfohlene Lösung für die meisten Szenarien im Zusammenhang mit Speichern von und Zugreifen auf benutzerdefinierte Daten.Open extensions are the recommended solution for most scenarios involving storing and accessing custom data. Wenn Sie benutzerdefinierte Daten für Outlook-MAPI-Eigenschaften, die noch nicht verfügbar gemacht werden über die Microsoft Graph-API-Metadatenzugreifen möchten, können Sie Erweiterte Eigenschaften und der REST-APIverwenden.If, however, you need to access custom data for Outlook MAPI properties that are not already exposed through the Microsoft Graph API metadata, you can use extended properties and its REST API. Sie können überprüfen, welche Eigenschaften die Metadaten zur verfügbar gemacht https://graph.microsoft.com/v1.0/$metadata.You can verify which properties the metadata exposes at https://graph.microsoft.com/v1.0/$metadata.

JSON-DarstellungJSON representation

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

{
  "extensionName": "string",
  "id": "string (identifier)"
}

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
extensionNameextensionName ZeichenfolgeString Ein eindeutiger Textbezeichner für eine offene Erweiterung. Erforderlich.A unique text identifier for an open type open extension. Required.
idid ZeichenfolgeString Eine vollqualifizierte ID, die den Erweiterungstyp mit dem extensionName-Element verkettet. Schreibgeschützt.A fully qualified identifier that concatenates the extension type with the extensionName. Read-only.

BeziehungenRelationships

KeineNone

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
PostPost openTypeExtension (in einer vorhandenen Ressourceninstanz) oder ein neues contact-, event- oder message-Objekt, das ein openTypeExtension-Objekt enthält.openTypeExtension (in an existing resource instance), or a new contact, event, or message that contains an openTypeExtension object Dient zum Erstellen eines openTypeExtension-Objekts in einer vorhandenen oder neuen Ressourceninstanz.Create an openTypeExtension object in an existing or new resource instance.
GetGet openTypeExtensionopenTypeExtension Dient zum Lesen der Eigenschaften und der Beziehungen des openTypeExtension-Objekts.Read properties and relationships of openTypeExtension object.
UpdateUpdate openTypeExtensionopenTypeExtension Dient zum Aktualisieren des openTypeExtension-Objekts.Update openTypeExtension object.
DeleteDelete KeineNone Dient zum Löschen des openTypeExtension-Objekts.Delete openTypeExtension object.