大网数据广告活动
Microsoft Graph 接口

在 Microsoft Graph 中选择 API 以创建和加入联机会议

· 52CE 我爱测

考虑何时在 Outlook 日历中使用日历 API 事件资源或云通信 API onlineMeeting 资源进行 Teams 和 Skype 会议。

Microsoft Graph 提供了两个 API 集,可在 Microsoft Teams 或 Skype 上安排和加入联机会议:

选择如下所示:

  • 一种简便的编程方法,可在 Outlook 日历中设置一个联机会议,与会者可在该日历中单击加入会议,并在 Teams 或 Skype 中继续其体验。
  • 在应用中,可通过更丰富的编程方式集成 Teams 或 Skype 功能,实现更好的自定义体验。

为方案选择 API 时的注意事项

选择日历 API,以获得与 Outlook 日历的简化内置集成,从而在 Outlook 日历中生成联机会议事件:

  • 编程支持:
    • 应用可以 在 Outlook 日历中作为联机会议直接创建或更新事件,并在 Outlook 日历事件中插入一个“加入 Teams 会议”blob。
    • 应用可通过 Internet 或拨号方式获取用于加入会议的属性。
  • 与会者的以编程方式创建的日历事件 UI 体验与通过 Outlook UI 创建的任何事件完全相同:
    • 与会者可以选择联机或亲自出席会议。
    • 与会者可以单击“加入 Teams 会议”blob 以通过 Internet 或拨号方式加入会议。
    • 如果已配置,则与会者可使用 Teams 的其他丰富功能(包括视频会议和会议厅)。

Note: 与 Outlook 日历集成假设管理员已在 Outlook 中设置了联机会议。 使用 API 前,请验证支持。

选择云通信 API 以获得灵活性和更广泛的编程支持:

  • 应用具有更大的灵活性,可以进一步将 API 结果与业务线和其他应用集成。 该 API 与任何特定日历保持分离,并且不会在任何日历中创建事件。
  • 应用可为与会者提供以下功能:
    • 基于区域设置的加入信息。
    • 通过 Internet 或拨号方式加入会议。
    • 视频会议。
    • 其他安全功能(如会议厅)和自动与会者许可(预览)。
    • 将会议与 Microsoft Teams 聊天相关联。

比较 API

下表详细介绍了 API 级别的区别。

联机会议功能 日历 API(事件资源) 云通信 API(onlineMeeting 资源)
主要 API 成员 事件资源: - isOnlineMeeting 属性 - onlineMeetingInfo 类型的 onlineMeeting 属性 - onlineMeetingProvider 属性 日历资源: - allowedOnlineMeetingProviders 属性 - defaultOnlineMeetingProvider 属性 联机会议资源 音频会议资源
与日历项目的集成 - 创建或 更新事件 API 会自动将生成的 Outlook 日历 事件设置为联机会议。-使用返回的 Outlook 日历 事件 的 isOnlineMeeting、onlineMeeting 和 onlineMeetingProvider 属性。 - 创建 API 可返回与特定日历类型无关的联机会议资源。 - 不会创建或更新任何 Outlook 事件。 - 将返回的 联机会议 资源信息集成到适合你的方案的应用体验中。 - 使用 createOrGet 返回具有指定 externalId 值的联机会议,或者创建一个外部值(如果不存在),以简化将生成的会议嵌入到第三方日历中的过程。
更改为脱机会议 - 否 - 一旦启用了用于联机加入的 事件,就不能更新该事件以使其成为脱机会议。- 不能更改 onlineMeetingProvider 属性,也不能将 isOnlineMeeting 设置为 false 以禁用联机会议。 否 - 创建 联机会议 资源后,只能删除它,而不能将其更改为脱机会议。
基于区域设置的加入信息 无直接 API 集成。 - 创建联机会议时,请使用 Accept-Language HTTP 标头。 - 请参阅示例。
通过 Internet 加入 (VoIP) 通过 onlineMeeting 属性访问 joinUrl。 使用 joinWebUrl 属性。
通过拨号方式加入 通过 onlineMeeting 属性访问: - conferenceId、quickDial、phones、tollFreeNumbers、tollNumber。 通过 audioConferencing 属性访问: - conferenceId、tollFreeNumber、tollNumber。 - dialinUrl 用于可在外部访问的网页,其包含拨入信息,便于与第三方应用集成。
通过视频会议(音频和视频)加入 无直接 API 集成。 使用 videoTeleconferenceId 属性。
会议厅和自动准许与会者加入联机会议 - 无直接 API 集成。- 在事件的已注入“加入 Teams 会议”blob 中,如果管理员启用了“会议选项”链接,则与会者可以单击该链接来访问会议厅。 - API 将来自组织者所在公司和联合公司的与会者以及其他与会者(包括匿名与会者)区分开。 - 使用 autoAdmittedUsers 属性(预览)。
与 Teams 聊天相关 无直接 API 集成。 使用 chatInfo 属性。

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 angelgolfer-ms)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。