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

Microsoft Teams API 许可和付款要求

· 52CE 我爱测

了解适用于 microsoft Teams API 的许可和付款模型,Microsoft Graph:model=A、model=B 和评估模式。

本文介绍 Microsoft Graph 中 Microsoft Teams API 的许可和付款要求。

某些 API 提供通过 model 查询参数选择许可和付款模型的选项;其他 API 仅支持某一个模型或不支持许可和付款模型。 以下 API 具有消耗费用:

以下许可模型可用:

Note: 从 2022 年 7 月 5 日开始,这些 API 的定价事件正式发布。 我们需要应用程序完成此表单以提供活动的 Azure 订阅,以便计费。 有关详细信息,请参阅最近更新。

model=A 要求

model=A 限于执行安全性或符合性功能的应用程序。 有关详细信息,请参阅 Microsoft Azure Services 产品条款的安全与合规性应用程序部分的 API 条款。

API 需要许可证的人员 种子设定容量 其他用途的价格 备注
chatMessage 更改通知 邮件发件人 每个应用每个月每个用户 800 条消息 每条消息 0.00075 美元 种子设定容量与 conversationMember 更改通知共享
conversationMember 更改通知 租户中的任何用户 每个应用每个月每个用户 800 条通知 每条通知 0.00075 美元 种子设定容量与 chatMessage 更改通知共享
为用户在所有聊天中获取消息 已命名用户 每个应用每个月每个用户 1600 条消息 每条消息 0.00075 美元 命名用户是在 GET 请求 URL 中标识的用户。 每个 API 请求的最小费用为 1 条消息。 种子设定容量与通道导出共享。
在所有通道中获取消息 任何团队成员 每个应用每个月每个用户 1600 条消息 每条消息 0.00075 美元 每个 API 请求的最小费用为 1 条消息。 种子设定容量与聊天导出共享。
正在更新 chatMessage 的 policyViolation 邮件发件人 每个应用每个月每个用户 800 条消息 每条消息 0.00075 美元

model=B 要求

model=B 仅限于不执行安全或合规性功能的应用程序。 有关详细信息,请参阅 Microsoft Azure Services 产品条款的安全与合规性应用程序部分的 API 条款。

API 需要许可证的人员 种子设定容量 其他用途的价格 备注
chatMessage 更改通知 不适用 无 每条消息 0.00075 美元
conversationMember 更改通知 不适用 无 每条通知 0.00075 美元
为用户在所有聊天中获取消息 不适用 无 每条消息 0.00075 美元 每个 API 请求的最小费用为 1 条消息。
在所有通道中获取消息 不适用 无 每条消息 0.00075 美元 每个 API 请求的最小费用为 1 条消息。

评估模式(默认)要求

API 需要许可证的人员 种子设定容量 其他用途的价格 备注
chatMessage 更改通知 不适用 每个应用每月 500 条消息 不适用
conversationMember 更改通知 不适用 每个应用每月 500 条消息 不适用
为用户在所有聊天中获取消息 不适用 每个应用每月 500 条消息 不适用 每个 API 请求的最小费用为 1 条消息。
在所有通道中获取消息 不适用 每个应用每月 500 条消息 不适用 每个 API 请求的最小费用为 1 条消息。
正在更新 chatMessage 的 policyViolation 不适用 每个应用每月 500 条消息 不适用

在评估模式下,种子设定容量在所有 API 之间共享。超出种子设定容量后,具有许可和付款要求的 API 调用将失败,并出现 402 错误代码,另外,具有许可和付款要求的订阅将不会发送更改通知。

model=A 需要的许可证

用户将需要支持 Microsoft 通信 DLP 服务计划的许可证,例如这些受支持的许可证之一。 需要许可证的用户因 API 而异;有关详细信息,请参阅model=A要求。

来宾用户不受这些许可要求的约束。 同样地,从租户外部发送的消息(联合聊天)不受约束。 消耗计量仍适用。

租户所有者(而不是应用所有者)负责确保用户获得正确许可。 管理员可以使用 Teams 管理中心中的信息保护许可证报告来查看哪些用户没有受支持的许可证。

许多受支持的许可证提供免费试用版。 例如,Office 365 E5 在 Buy 按钮下方有一个 Free trial 链接。

你可以通过 Microsoft 365 开发人员计划获取包含 25 个用户许可证的免费 Microsoft 365 E5 开发人员沙盒订阅。

超出了不正确的许可和评估模式种子设定容量

如果检测到不正确的许可,API 调用将失败,并且不会返回数据。 具体而言,对于大多数 API,尝试为未经授权的用户获取消息将导致 402 错误代码。 对于更改通知,未经授权的用户发送的消息将不会生成更改通知。 同样,在评估模式下使用的超出种子设定容量的 API 调用和更改通知将失败。

示例错误类型 状态代码 示例错误消息
未满足 E5 许可证要求 402(需要付款) ...needs a valid license to access this API..., ...tenant needs a valid license to access this API...
修补程序 API 不支持模型 B 402(需要付款) ...query parameter 'model' does not support value 'B' for this API. Use billing model 'A'...
超出评估容量 402(需要付款) ...evaluation mode capacity has been exceeded. Use a valid billing model...

Note: 成功的 API 调用并不意味着已实施适当的许可。 同样,评估模式的 API 成功并不能保证调用在种子设定容量内。

种子设定容量

种子设定容量是应用在对消耗量计费之前可以使用的容量。 容量在租户级别共用—将租户中所有用户的种子设定容量相加,并与租户中的应用使用情况进行比较。 种子设定容量是每个租户的每个应用—如果另一个应用用完,应用不会耗尽种子容量。

种子设定的容量因 API 而异;请参 阅model=A 要求 和 model=B 要求。

用于其他用途的最近更新和价格

2021 年 10 月,我们就这些 API 的使用即将产生的费用进行了通信。如先前公布的那样,这些价格将于 2022 年 7 月 5 日生效。 如果你的应用程序是或将调用这些 API 中的任何一个,我们要求你完成此请求表单,提供有效的 Azure 订阅。 当提交此表单以注册应用程序后,你可以继续使用这些 API。 我们将按照后续步骤将应用程序加入计费。

请注意,拥有 应用注册 的组织负责付款。 Azure 订阅必须在同一租户中处于活动状态。 对于 多租户应用,拥有应用注册的组织可能不同于运行应用的组织。

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

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

资料来源与适用范围

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

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

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