openTypeExtension 资源类型(开放扩展)

开放扩展(以前被称为 Office 365 数据扩展)提供了一种简单方法,可直接将非类型化属性添加到 Microsoft Graph 中的资源。开放扩展由 openTypeExtension 资源表示。添加到资源的任何开放扩展都会显示在 extensions 导航属性中,该属性派生自 extension 抽象类型。每个扩展都有一个 extensionName 属性,它是所有扩展以及自定义数据的唯一一个可预定义、可写入的属性。帮助确保扩展名称唯一性的一种方法是使用反向域名名称系统 (DNS) 格式,该格式取决于你拥有的域,例如 Com.Contoso.ContactInfo。请勿在扩展名中使用 Microsoft 域(Com.MicrosoftCom.OnMicrosoft)。

开放扩展示例:使用开放扩展向用户添加自定义数据

一般可用性(GA: /v1.0 和 /beta)或预览版 (/beta) 对应版本中的以下资源支持开放扩展。

资源 版本
管理单元 仅供预览
日历事件 GA
日历事件 GA
组对话线程帖子 GA
设备 GA
GA
邮件 GA
组织 GA
个人联系人 GA
用户 GA

使用开放扩展(针对 Outlook 资源)还是使用扩展属性?

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

JSON 表示形式

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

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

属性

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

关系

方法

方法 返回类型 说明
Post 现有资源实体中的 openTypeExtension 或包含 openTypeExtension 对象的新联系人事件消息 在现有或新建资源实例中创建 openTypeExtension 对象。
获取 openTypeExtension 读取 openTypeExtension 对象的属性和关系。
更新 openTypeExtension 更新 openTypeExtension 对象。
删除 删除 openTypeExtension 对象。