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

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Offene Erweiterungen (früher als Office 365-Datenerweiterungen bezeichnet) bieten eine einfache Möglichkeit zum direkten hinzufügen nicht typisierter Eigenschaften zu einer Ressource in Microsoft Graph.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 ÜberlegungenOutlook-specific considerations

Jede offene Erweiterung, die für eine Outlook-Ressource (Ereignis, Nachricht oder persönlicher Kontakt) vorhanden ist, wird in einer MAPI-benannten Eigenschaftgespeichert.Each open extension present on an Outlook resource (event, message, or personal contact) is stored in a MAPI named property. Wenn Sie offene Erweiterungen für Outlook erstellen, sollten Sie Bedenken, dass MAPI-benannte Eigenschaften eine endliche Ressource im Postfach eines Benutzers sind.When you create open extensions for Outlook, consider that MAPI named properties are a finite resource in a user's mailbox. Wenn das benannte Eigenschafts Kontingent eines Benutzers erschöpft ist, können Sie keine weiteren 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 zu unerwartetem Verhalten von Clients führen, die auf benannten Eigenschaften basieren, um zu funktionieren.This can result in unexpected behavior from clients that rely on named properties to function.

Wenden Sie die folgenden Richtlinien an, wenn Sie offene Erweiterungen für Outlook-Ressourcen erstellen:Apply the following guidelines when you create open extensions on Outlook resources:

  • Erstellen Sie die Mindestanzahl an erforderlichen Erweiterungen.Create the minimum number of extensions required. Die meisten Anwendungen sollten nicht mehr als eine Erweiterung erfordern.Most applications should require no more than one extension. Extensions haben keine festgelegten Eigenschaften oder Strukturen, sodass Sie mehrere Werte in einer einzelnen Erweiterung speichern können.Extensions have no set defined properties or structure, so you can store multiple values in a single extension.
  • Vermeiden Sie Benennungs Erweiterungen auf Variable Weise (beispielsweise basierend auf der Benutzereingabe usw.).Avoid naming extensions in a variable manner (such as based on user input, etc.). Jedes Mal, wenn eine geöffnete Erweiterung mit einem neuen Namen erstellt wird, der noch nicht im Postfach eines Benutzers verwendet wurde, wird eine neue 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. Durch das Entfernen der Erweiterung wird die benannte Eigenschaft nicht entfernt.Removing the extension does not remove the named property.

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

Offene Erweiterungen sind die empfohlene Lösung für die meisten Szenarios, bei denen benutzerdefinierte Daten gespeichert und aufgerufen werden sollen.Open extensions is the recommended solution for most scenarios involving storing and accessing custom data. 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, können Sie erweiterte Eigenschaften und deren REST-API verwenden.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 bei https://graph.microsoft.com/v1.0/$metadataverfügbar macht.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 StringString Ein eindeutiger Textbezeichner für eine OpenType-Datenerweiterung. Erforderlich.A unique text identifier for an open type data 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 eines neuen Kontakts, Ereignissesoder einer Nachricht , die 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 KeinerNone Dient zum Löschen des openTypeExtension-Objekts.Delete openTypeExtension object.