openTypeExtension リソース タイプ (オープン拡張機能)openTypeExtension resource type (open extensions)

(Office 365 のデータ拡張機能と呼ばれていました) 開いているの拡張機能では、直接グラフ内のリソースに型指定されていないプロパティを追加する簡単な方法を提供します。Open extensions (formerly known as Office 365 data extensions) provide an easy way to directly add untyped properties to a resource in Microsoft Graph.

オープン拡張機能は、openTypeExtension リソースで表されます。Open extensions are represented by the openTypeExtension resource. リソースに追加されるオープン拡張機能は extensions ナビゲーション プロパティに表示されます。このプロパティは、extension 抽象型から派生します。Any open extension added to a resource shows up in the extensions navigation property, which is derived from the extension abstract type. 各拡張機能には extensionName プロパティがあります。このプロパティは、すべての拡張機能とカスタム データで唯一定義済みの書き込み可能なプロパティです。Each extension has an extensionName property which is the only pre-defined, writable property for all extensions, along with your custom data.

拡張機能名が必ず一意であるようにする方法の 1 つは、_独自のドメイン_に依存する逆引きドメイン ネーム システム (DNS) 形式 (例: 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. 拡張機能名に Microsoft ドメイン (Com.Microsoft または Com.OnMicrosoft) を使用しないでください。Do not use the Microsoft domain (Com.Microsoft or Com.OnMicrosoft) in an extension name.

オープン拡張機能の例:オープン拡張機能を使用してカスタム データをユーザーに追加するOpen extension example: Add custom data to users using open extensions

オープン拡張機能は、次のリソースの対応するバージョンの一般提供 (GA: /v1.0 および /ベータ) またはプレビュー (/ベータ) でサポートされています。Open extensions are supported by the following resources in the corresponding versions - general availability (GA: /v1.0 and /beta) or preview (/beta).

リソースResource バージョンVersion
管理単位Administrative unit プレビューのみPreview only
予定表イベントCalendar event GAGA
グループ予定表イベントGroup calendar event GAGA
グループ会話スレッド投稿Group conversation thread post GAGA
devicedevice GAGA
グループgroup GAGA
メッセージmessage GAGA
組織organization GAGA
個人用連絡先Personal contact GAGA
ユーザーuser GAGA

Outlook に固有の考慮事項Outlook-specific considerations

(イベント、メッセージ、または個人用の連絡先)、Outlook のリソース上に存在の開いている各拡張機能は、 MAPI の名前付きプロパティに格納されます。Each open extension present on an Outlook resource (event, message, or personal contact) is stored in a MAPI named property. Outlook を開いている拡張機能を作成するときは、MAPI プロパティを名前付きのユーザーのメールボックス内の有限のリソースであることを検討します。When you create open extensions for Outlook, consider that MAPI named properties are a finite resource in a user's mailbox. ユーザーの名前付きプロパティのクォータが不足すると、そのユーザーに対して複数の名前付きプロパティを作成できません。When a user's named property quota is exhausted, you can't create any more named properties for that user. その場合、関数の名前付きプロパティに依存するクライアントからの予期しない動作します。This can result in unexpected behavior from clients that rely on named properties to function.

Outlook のリソースで開いている拡張機能を作成するときは、次のガイドラインを適用します。Apply the following guidelines when you create open extensions on Outlook resources:

  • 必要な拡張の最小数を作成します。Create the minimum number of extensions required. ほとんどのアプリケーションは、複数の拡張機能を必要があります。Most applications should require no more than one extension. 拡張機能があるないプロパティの設定を定義または構造体は、単一の拡張機能に複数の値を格納することができますので。Extensions have no set defined properties or structure, so you can store multiple values in a single extension.
  • (などのユーザー入力などに基づきます)。 変数の方法で拡張機能の名前付けをしないでください。Avoid naming extensions in a variable manner (such as based on user input, etc.). 前に、ユーザーのメールボックスで使用されていない新しい名前で開いている拡張機能を作成するたびに、新しい MAPI 名前付きプロパティが作成されます。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. 拡張子を削除しても、名前付きプロパティは削除されません。Removing the extension does not remove the named property.

(Outlook のリソース) の拡張子を開くか、拡張プロパティを使用します。Use open extensions (for Outlook resources) or extended properties

開いている拡張機能を保存して、カスタムのデータへのアクセスに関連するほとんどのシナリオで推奨される解決策です。Open extensions are the recommended solution for most scenarios involving storing and accessing custom data. ただし、 Microsoft グラフ API メタデータを通じて公開されていない Outlook MAPI プロパティのカスタムのデータにアクセスする必要がある場合は、拡張プロパティおよびその他の APIを使用できます。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. メタデータを公開するプロパティを確認することができますhttps://graph.microsoft.com/v1.0/$metadataYou can verify which properties the metadata exposes at https://graph.microsoft.com/v1.0/$metadata.

JSON 表記JSON representation

以下は、リソースの JSON 表記です。Here is a JSON representation of the resource.

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

プロパティProperties

プロパティProperty Type 説明Description
extensionNameextensionName StringString オープン型のオープン拡張機能の一意のテキスト識別子。必須。A unique text identifier for an open type open extension. Required.
idid StringString extensionName と拡張子タイプを連結する完全修飾識別子。読み取り専用。A fully qualified identifier that concatenates the extension type with the extensionName. Read-only.

リレーションシップRelationships

なしNone

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
PostPost (既存リソースのインスタンス内の) openTypeExtension、または、openTypeExtension オブジェクトを含む新しいcontacteventmessageopenTypeExtension (in an existing resource instance), or a new contact, event, or message that contains an openTypeExtension object 既存または新規のリソース インスタンス内に openTypeExtension オブジェクトを作成します。Create an openTypeExtension object in an existing or new resource instance.
GetGet openTypeExtensionopenTypeExtension openTypeExtension オブジェクトのプロパティと関係を読み取ります。Read properties and relationships of openTypeExtension object.
更新するUpdate openTypeExtensionopenTypeExtension openTypeExtension オブジェクトを更新します。Update openTypeExtension object.
削除Delete なしNone openTypeExtension オブジェクトを削除します。Delete openTypeExtension object.