反馈 编辑

openTypeExtension 资源类型（开放扩展）

  • 项目

命名空间：microsoft.graph

表示开放扩展（以前称为 Office 365 数据扩展），这是一种 可扩展性选项，提供一种简单的方法，可直接将非类型化属性添加到 Microsoft Graph 中的资源。

添加到资源的任何打开扩展都显示在 扩展 导航属性中。 每个扩展都有 extensionName 属性（这是所有扩展的预定义唯一可写属性）和自定义数据。 一种有助于确保扩展名称唯一性的方法是，使用反向域名系统 (DNS) 格式，此格式依赖 用户自己的域。例如，com.contoso.ContactInfo。 请勿 在扩展名称中使用 Microsoft 域（com.microsoft 或 com.onmicrosoft）。

派生自 扩展 抽象类型。

以下资源支持开放扩展。

注意： * 由于现有的服务限制，代理无法在共享邮箱日历中创建已追加开放扩展的事件。 尝试这样做将导致 ErrorAccessDenied 响应。

有关 Microsoft Graph 扩展性（包括开放扩展的限制）的详细信息，请参阅 使用扩展向资源添加自定义属性 ，以及 使用开放扩展向用户添加自定义数据。

Outlook 特定注意事项

Outlook 资源（事件、邮件或个人联系人）上存在每个开放扩展均存储在 MAPI 命名属性中。 为 Outlook 创建开放扩展时，请考虑 MAPI 命名属性为用户邮箱中的有限资源。 当用户的命名属性配额用尽后，无法再为该用户创建任何其他命名属性。 这可能会导致依赖命名属性工作的客户端中出现异常行为。

在 Outlook 资源中创建开放扩展时，请遵循以下指导原则：

  • 创建所需的最少数量的扩展。 大多数应用程序只需要一个扩展。 扩展未设定定义的属性或结构，因此，可以在一个扩展中存储多个值。
  • 避免以可变方式命名扩展，如基于用户输入等。 每次使用用户邮箱中先前未使用过的新名称创建开放扩展时，将会创建新的 MAP 命名属性。 删除扩展不会删除命名属性。

使用开放扩展（针对 Outlook 资源）或扩展属性

开放扩展是大部分涉及存储和访问自定义数据的应用场景的推荐解决方案。但如果需要访问尚未通过 Microsoft Graph API 元数据 公开的 Outlook MAPI 属性的自定义数据，则可以使用 扩展属性及其 REST API。要确认元数据公开了哪些属性，请访问 https://graph.microsoft.com/v1.0/$metadata。

方法

方法 返回类型 说明
创建 openTypeExtension（在现有资源实例中），或新的 todoTask、todotasklist联系人、事件、消息、帖子、todoTask或包含 openTypeExtension 对象的 todoTaskList。 在现有的或新的资源实例中创建 openTypeExtension 对象。
获取 openTypeExtension 读取 openTypeExtension 对象的属性和关系。
更新 openTypeExtension 更新 openTypeExtension 对象。
删除 无 删除 openTypeExtension 对象。

属性

属性 类型 说明
extensionName String 开放类型数据扩展的唯一文本标识符。必需。
id String 连接具有 extensionName 扩展类型的完全限定的标识符 。只读。

关系

无

JSON 表示形式

下面是资源的 JSON 表示形式。

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

另请参阅