openTypeExtension-Ressourcentyp (offene Erweiterungen)

Offene Erweiterungen (bisher als Office 365-Datenerweiterungen bezeichnet) bieten Ihnen eine einfache Möglichkeit zum direkten Hinzufügen nicht typisierter Eigenschaften zu einer Ressource in Microsoft Graph. Offiene Erweiterungen werden mithilfe der openTypeExtension-Ressource dargestellt. Alle offenen Erweiterungen, die einer Ressource hinzugefügt wurden, werden in der extensions-Navigationseigenschaft angezeigt, die vom abstrakten Typ extension abgeleitet wird. Jede Erweiterung weist eine extensionName-Eigenschaft auf, die die einzige vordefinierte, schreibbare Eigenschaft für alle Erweiterungen zusammen mit ihren benutzerdefinierten Daten ist. 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. Verwenden Sie in Erweiterungsnamen auf keinen Fall die Microsoft-Domäne (Com.Microsoft oder Com.OnMicrosoft).

Offene Erweiterungen werden von den folgenden Ressourcen in den entsprechenden Versionen unterstützt: - Allgemein verfügbar (GA: /v1.0 und /beta) oder Vorschau (/beta).

Ressource Version
Administrative Einheit Nur Vorschau
Kalenderereignis Allgemein verfügbar
Kalenderereignis für Gruppe Allgemein verfügbar
Unterhaltungsthread der Gruppe posten Allgemein verfügbar
Gerät Nur Vorschau
Gruppe Nur Vorschau
Nachricht Allgemein verfügbar
Organisation Nur Vorschau
Privater Kontakt Allgemein verfügbar
Benutzer Nur Vorschau

Sollen offene Erweiterungen (für Outlook-Ressourcen) oder erweiterte Eigenschaften verwendet werden?

Offene Erweiterungen sind die empfohlene Lösung für die meisten Szenarios, bei denen benutzerdefinierte Daten gespeichert und aufgerufen werden sollen. 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. Unter https://graph.microsoft.com/v1.0/$metadata können Sie überprüfen, welche Eigenschaften die Metadaten verfügbar machen.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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

Eigenschaften

Eigenschaft Typ Beschreibung
extensionName String Ein eindeutiger Textbezeichner für eine offene Erweiterung. Erforderlich.
id String Eine vollqualifizierte ID, die den Erweiterungstyp mit dem extensionName-Element verkettet. Schreibgeschützt.

Beziehungen

Keine

Methoden

Methode Rückgabetyp Beschreibung
Post openTypeExtension oder Nachricht, Ereignis oder Kontakt mit einem openTypeExtension-Objekt. Dient zum Erstellen eines openTypeExtension-Objekts in einer vorhandenen oder neuen Ressourceninstanz.
Get openTypeExtension Dient zum Lesen der Eigenschaften und der Beziehungen des openTypeExtension-Objekts.
Update openTypeExtension Dient zum Aktualisieren des openTypeExtension-Objekts.
Delete Keine Dient zum Löschen des openTypeExtension-Objekts.