Type de ressource openTypeExtension (extensions d’ouverture)openTypeExtension resource type (open extensions)

Les extensions d’ouverture (auparavant appelées extensions de données Office 365) permettent d’ajouter directement et simplement des propriétés non typées à une ressource dans Microsoft Graph.Open extensions (formerly known as Office 365 data extensions) give you an easy way to directly add untyped properties to a resource in Microsoft Graph.

Les extensions d’ouverture sont représentées par la ressource openTypeExtension.Open extensions are represented by the openTypeExtension resource. Les extensions d’ouverture ajoutées à une ressource s’affichent dans la propriété de navigation extensions, dérivée du type de résumé extension.Any open extension added to a resource shows up in the extensions navigation property, which is derived from the extension abstract type. Chaque extension possède vos données personnalisées et une propriété extensionName, qui est la seule propriété prédéfinie et accessible en écriture pour toutes les extensions.Each extension has an extensionName property which is the only pre-defined, writable property for all extensions, along with your custom data.

Pour vérifier que les noms d’extension sont uniques, utilisez un format DNS (Domain Name System) inversé qui dépend de votre propre domaine, par exemple Com.Contoso.ContactInfo.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. N’utilisez pas le domaine Microsoft (Com.Microsoft ou Com.OnMicrosoft) dans un nom d’extension.Do not use the Microsoft domain (Com.Microsoft or Com.OnMicrosoft) in an extension name.

Pour voir un exemple d’extension d’ouverture, consultez la rubrique : Ajout de données personnalisées à des utilisateurs à l’aide des extensions d’ouvertureOpen extension example: Add custom data to users using open extensions

Les extensions d’ouverture sont prises en charge par les ressources suivantes dans les versions correspondantes : disponibilité générale (DG : /v1.0 et /bêta) ou aperçu (/bêta).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 unitAdministrative unit Aperçu uniquementPreview only
Calendar eventCalendar event Disponibilité généraleGA
Groupe calendar eventGroup calendar event Disponibilité généraleGA
Thread de conversation du groupe postGroup conversation thread post Disponibilité généraleGA
devicedevice DisponibleGA
groupgroup DisponibleGA
messagemessage Disponibilité généraleGA
organizationorganization DisponibleGA
Personal contactPersonal contact Disponibilité généraleGA
useruser Disponibilité généraleGA

Considérations spécifiques à OutlookOutlook-specific considerations

Chaque extension d’ouverture présente sur une ressource Outlook (événement, message ou contact personnel) est stockée dans une propriété nommée MAPI.Each open extension present on an Outlook resource (event, message, or personal contact) is stored in a MAPI named property. Lorsque vous créez des extensions d’ouverture pour Outlook, vous devez considérer les propriétés nommées MAPI comme des ressources limitées de la boîte aux lettres d’un utilisateur.When you create open extensions for Outlook, consider that MAPI named properties are a finite resource in a user's mailbox. Lorsque le quota de propriétés nommées d’un utilisateur est épuisé, vous ne pouvez plus en créer pour celui-ci.When a user's named property quota is exhausted, you can't create any more named properties for that user. Cela peut se traduire par un comportement inattendu de la part des clients dont le fonctionnement dépend des propriétés nommées.This can result in unexpected behavior from clients that rely on named properties to function.

Suivez les instructions ci-dessous lorsque vous créez des extensions d’ouverture sur des ressources Outlook :Apply the following guidelines when you create open extensions on Outlook resources:

  • Créez le nombre minimum d’extensions requises.Create the minimum number of extensions required. Les applications ne doivent généralement pas nécessiter plus d’une extension.Most applications should require no more than one extension. Dans la mesure où les extensions n’ont pas de propriétés ou de structure définies, vous pouvez stocker plusieurs valeurs au sein d’une même extension.Extensions have no set defined properties or structure, so you can store multiple values in a single extension.
  • Évitez de nommer les extensions sous un format variable (par exemple, en fonction des entrées utilisateur, etc.).Avoid naming extensions in a variable manner (such as based on user input, etc.). Chaque fois qu’une extension d’ouverture est créée avec un nouveau nom jamais utilisé dans la boîte aux lettres d’un utilisateur, une nouvelle propriété nommée MAPI est créée.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. La suppression de l’extension ne supprime pas la propriété nommée.Removing the extension does not remove the named property.

Utiliser des extensions d’ouverture (pour les ressources Outlook) ou des propriétés étenduesUse open extensions (for Outlook resources) or extended properties?

Les extensions d’ouverture constituent la solution recommandée pour la plupart des scénarios impliquant le stockage et l’accès à des données personnalisées.Data extensions is the recommended solution for most scenarios involving storing and accessing custom data. Néanmoins, si vous avez besoin d’accéder aux données personnalisées des propriétés MAPI Outlook qui ne figurent pas déjà dans les métadonnées de l’API Microsoft Graph, vous pouvez utiliser des propriétés étendues et leur API REST.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. Vous pouvez vérifier les propriétés qui figurent dans les métadonnées en accédant à https://graph.microsoft.com/v1.0/$metadata.You can verify which properties the metadata exposes at https://graph.microsoft.com/v1.0/$metadata.

Représentation JSONJSON representation

Voici une représentation JSON de la ressource.Here is a JSON representation of the resource.

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

PropriétésProperties

PropriétéProperty TypeType DescriptionDescription
extensionNameextensionName StringString Identificateur de texte unique pour une extension d’ouverture de type ouvert. Obligatoire.A unique text identifier for an open type open extension. Required.
idid ChaîneString Identificateur complet qui concatène le type d’extension avec extensionName. En lecture seule.A fully qualified identifier that concatenates the extension type with the extensionName. Read-only.

RelationsRelationships

AucunNone

MéthodesMethods

MéthodeMethod Type renvoyéReturn Type DescriptionDescription
PostPost openTypeExtension (dans une instance de ressource existante) ou un nouveau contact, événement ou message qui contient un objet openTypeExtension.openTypeExtension (in an existing resource instance), or a new contact, event, or message that contains an openTypeExtension object Créez un objet openTypeExtension dans une instance de ressource nouvelle ou existante.Create an openTypeExtension object in an existing or new resource instance.
GetGet openTypeExtensionopenTypeExtension Lisez les propriétés et les relations d’objet openTypeExtension.Read properties and relationships of openTypeExtension object.
UpdateUpdate openTypeExtensionopenTypeExtension Mettez à jour l’objet openTypeExtension.Update openTypeExtension object.
DeleteDelete AucunNone Supprimez l’objet openTypeExtension.Delete openTypeExtension object.