Microsoft Graph API 用于 Teams 全体大会现已普遍可用
内容提要
Microsoft Teams支持多种实时语音和视频体验，包括小型会议和大型虚拟活动。通过Microsoft Graph提供的API，开发者可以方便地调度和管理在线会议。现在，Teams全体大会API已正式发布，可用于构建自定义应用程序来同步数据、创建/更新/删除全体大会以及发送邮件通知。
延伸解读
全体大会与在线会议、网络研讨会的关键区别
Teams 的三种会议类型定位不同：在线会议最多 1000 人，支持音视频、聊天和屏幕共享互动；网络研讨会同样限 1000 人，但需提前注册，适合专家分享或培训；全体大会则面向大型直播场景，最多支持 10000 人，使用 Teams Premium 可扩展至 20000 人。参与者无需注册，主要通过问答与演讲者互动，而非直接聊天或语音。
新发布的 Graph API 资源及其用途
本次正式发布的 Teams 全体大会 API 包含三个核心资源：virtualEventTownhall 用于创建、获取、更新、发布和取消全体大会；virtualEventPresenter 用于管理演讲者；virtualEventSession 则代表全体大会的单个会话，继承在线会议的属性。开发者可基于这些 API 构建自定义应用，实现数据同步、创建/更新/删除全体大会以及自定义邮件通知。
使用 API 前需了解的角色与权限限制
全体大会涉及组织者、演讲者和参与者三种角色。组织者必须是组织内员工，负责配置大会细节；演讲者可以是内部或外部人员；参与者通过邀请或链接加入。通过 Graph API 创建全体大会时，只能使用委托权限代表组织者调用，且只有组织者和协作者能更新或删除大会。此外，Teams 租户管理员必须为自定义应用授权适当的权限。
邮件通知的默认行为与自定义选项
使用 Create town hall API 创建全体大会时，默认会关闭对参与者的邮件通知，但 Teams 仍会向组织者、协作者和演讲者（内部或外部）发送邮件或邀请。如果希望使用自己的邮件基础设施发送大会相关通知，可以在创建时通过设置属性 isAttendeeEmailNotificationEnabled 来关闭参与者的邮件通知，从而实现自定义的邮件通信体验。
Q&A
Microsoft Teams的全体大会支持多少名参与者？
全体大会最多可容纳20000名参与者。
开发者如何使用Microsoft Graph API管理全体大会？
开发者可以使用Microsoft Graph API创建、更新、发布和取消全体大会。
全体大会的用户角色有哪些？
全体大会的用户角色包括组织者、演讲者和参与者。
Microsoft Teams支持哪些类型的会议？
Microsoft Teams支持在线会议、网络研讨会和全体大会。
如何通过API实现全体大会的数据同步？
可以使用Get townhall API拉取全体大会数据，并通过Create town hall API创建全体大会。
全体大会的参与者如何与演讲者互动？
参与者通过问答与演讲者互动，而不是通过聊天或音频直接互动。
