本文介绍 Microsoft Graph 中 Microsoft Teams API 的许可和付款要求。
某些 API 提供通过 model 查询参数选择许可和付款模型的选项;其他 API 仅支持某一个模型或不支持许可和付款模型。 以下 API 具有消耗费用:
以下许可模型可用:
-
model=A限于执行安全或合规性功能或需要受支持的许可证的应用程序。 将来,应用还需要为其在种子设定容量之外使用的消息付费。 -
评估模式(默认) 允许访问每个请求应用程序的 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,规范化链接,移除外部媒体和导航标记。
