フィードバック 編集

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

  • [アーティクル]

名前空間: microsoft.graph

オープン拡張 (旧称は Office 365 のデータ拡張機能) を表します。これは、Microsoft Graph のリソースに型指定されていないプロパティを直接追加する簡単な方法を提供する拡張機能オプションです。

リソースに追加されるオープン拡張機能は extensions ナビゲーション プロパティに表示されます。 各拡張機能には extensionName プロパティがあります。このプロパティは、すべての拡張機能とカスタム データで唯一定義済みの書き込み可能なプロパティです。 拡張機能名が必ず一意であるようにする方法の 1 つは、独自のドメイン に依存する逆引きドメイン ネーム システム (DNS) 形式 (例: com.contoso.ContactInfo) を使用することです。 拡張機能名に Microsoft ドメイン (com.microsoft または com.onmicrosoft) を 使用しないでください。

拡張機能抽象型から派生します。

開いている拡張機能は、次のリソースでサポートされています。

メモ: * 既存のサービスの制限により、代理人は共有メールボックス 予定表でオープン拡張追加イベントを作成することはできません。 これを試みると、ErrorAccessDenied応答が返されます。

オープン拡張機能の制限を含む Microsoft Graph の機能拡張の詳細については、「 拡張機能を使用してリソースにカスタム プロパティを追加する 」と「オープン拡張機能を使用してカスタム データをユーザーに追加する」を参照してください。

Outlook 固有の考慮事項

Outlook リソース (イベント、メッセージ、個人用連絡先) に存在する各オープン拡張は、MAPI 名前付きプロパティに保存されます。 Outlook のオープン拡張を作成する場合は、MAPI 名前付きプロパティがユーザーのメールボックスで有限のリソースであることを考慮してください。 ユーザーの名前付きプロパティのクォータがすべて使用されると、それ以上、そのユーザーに対して名前付きのプロパティを作成することはできません。 これにより、機能する名前付きプロパティに依存しているクライアントから、予期しない動作が発生する可能性があります。

Outlook リソースのオープン拡張を作成する場合は、次のガイドラインを適用します。

  • 必要な拡張機能の最小数を作成します。 ほとんどのアプリケーションで必要な拡張機能は、1 つのみです。 拡張機能には、定義済みのプロパティや構造体が設定されていないため、1 つの拡張機能に複数の値を保存できます。
  • 拡張機能には変更可能な方法 (ユーザー入力に基づくなど) で名前を付けないでください。 ユーザーのメールボックスで以前に使用されていない新しい名前でオープン拡張が作成されるたびに、新しい MAPI 名前付きプロパティが作成されます。 拡張機能を削除しても、名前付きプロパティは削除されません。

オープン拡張 (Outlook リソース用) または拡張プロパティを使用する

オープン拡張機能は、カスタム データの格納およびカスタムデータへのアクセスを必要とするほとんどのシナリオに対して推奨される解です。ただし、拡張プロパティとこの REST API は、Microsoft Graph API のメタデータを通じてまだ公開されていない Outlook MAPI プロパティのカスタム データにアクセスする必要がある場合に使用できます。メタデータが公開するプロパティは、https://graph.microsoft.com/v1.0/$metadata で確認できます。

メソッド

メソッド 戻り値の型 説明
Create (既存のリソース インスタンス内の) openTypeExtension、または新しい todoTask、todotasklistcontact、event、message、post、todoTask、または openTypeExtension オブジェクトを含む todoTaskList。 既存または新規のリソース インスタンス内に openTypeExtension オブジェクトを作成します。
Get openTypeExtension openTypeExtension オブジェクトのプロパティと関係を読み取ります。
Update openTypeExtension openTypeExtension オブジェクトを更新します。
削除 なし openTypeExtension オブジェクトを削除します。

プロパティ

プロパティ 型 説明
extensionName String オープン型のデータ拡張情報の一意のテキスト識別子。必須。
id String extensionName と拡張子タイプを連結する完全修飾識別子。読み取り専用。

リレーションシップ

なし

JSON 表記

以下は、リソースの JSON 表記です。

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

関連項目