使用 SharePoint Embedded 开发企业级应用
内容提要
SharePoint Embedded 更新为开发者提供从开发到生产的指导：明确容器与租户站点上限（约200万）、每容器40个可搜索列，并说明API限流（每应用每租户每分钟1.2万资源单位）及重试、降并发等应对策略。新增Entra服务主体认证和更细粒度Graph权限，支持最小权限访问。应用可集成Office实时共同编辑、自动保存、版本历史与共享链接。还推出MCP服务器预览和VS Code扩展，简化容器创建与管理。
延伸解读
容量规划：容器策略与租户上限
文章明确租户级站点与容器上限约为200万，并建议按客户端或活动划分容器。这意味着架构设计需提前评估消费租户的容器增长，避免触及上限。若预计超出，应联系微软代表讨论扩展方案。同时，每容器40个可搜索列的上限要求开发者在元数据设计时精打细算，优先保留高频检索字段。
限流应对：从被动重试到主动设计
SharePoint Embedded默认API限流为每应用每租户每分钟1.2万资源单位，约为SharePoint Online千许可证租户的9.6倍。文章强调将429/503视为临时压力，遵循Retry-After等待、有界重试、降低并发，并监控各范围用量。开发者应在设计阶段减少权限密集型操作、分散负载到多个容器，而非仅靠重试逻辑兜底。
权限治理：最小权限与身份选择
文章建议避免不必要的叠加权限，并支持Entra服务主体（含安全组）作为认证选项。应用可通过委托访问代表登录用户操作，或使用仅应用访问。微软推荐尽可能采用委托访问，以便操作关联到具体用户，提升安全与问责。Graph权限方面，可用FileStorageContainer.Selected等更细粒度权限替代Files.Read.All，落实最小权限原则。
协作能力与开发工具：降低自建成本
应用可直接调用Office服务实现Word、Excel、PowerPoint实时共同编辑、自动保存、版本历史与共享链接，无需自建协作引擎。共享范围受租户/管理员配置影响。此外，MCP服务器预览支持通过自然语言创建和管理容器类型，VS Code扩展提供引导式操作。这些工具可简化从开发到生产的流程，但MCP仍处预览阶段，需关注其稳定性。
Q&A
SharePoint Embedded 每个租户最多可以创建多少个容器？
根据文章，当前限制为每个租户最多 200 万个站点和容器（截至发布时）。建议在生产发布前确认最新限制。
SharePoint Embedded 的 API 限流阈值是多少？如何应对限流？
API 限制为每个应用每个租户每分钟 12,000 个资源单位。应对策略包括：将 429/503 视为临时压力，按 Retry-After 等待，使用速率限制标头监控容量，进行有界重试（退避后停止），降低并发，并按应用、租户、用户和容器监控使用情况。
SharePoint Embedded 支持哪些身份验证方式？
支持 Microsoft Entra 服务主体类型，包括 Entra ID 和 Microsoft 365 安全组。应用从 Entra ID 应用注册开始，通过 Graph 与容器交互，可使用委托访问（代表登录用户）或仅应用访问。建议尽可能使用委托访问以提高安全性和问责性。
如何为 SharePoint Embedded 应用实现最小权限访问？
使用更细粒度的 Microsoft Graph 权限，例如用 FileStorageContainer.Selected 替代更宽泛的 Files.Read.All 来执行预览文件等操作，从而控制应用可访问的内容。
SharePoint Embedded 应用能否集成 Office 实时共同编辑？有哪些协作功能？
可以。应用能启动 Word、Excel、PowerPoint 文件进行实时共同编辑，并自动获得自动保存、版本历史、共享链接、@提及（ licensed 用户）以及范围访问级别（任何人、组织内人员、特定人员、已有访问权限的人员）。还支持在 Web 或桌面客户端打开文件，或嵌入只读预览。
SharePoint Embedded 提供了哪些开发工具来简化容器管理？
提供了 SharePoint Embedded MCP 服务器（预览版），可通过自然语言在编码代理中预配和管理资源，支持 GitHub Copilot、Claude Desktop、Cursor 等客户端；还提供 Visual Studio Code 扩展，可通过引导视图创建容器类型、配置应用和计费、注册容器类型、创建容器并加载示例应用。
