获得团队合作
命名空间:microsoft.graph
获取 团队协作 对象的属性和关系,例如组织的区域以及是否启用了 Microsoft Teams。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | Teamwork.Read.All | 不可用。 |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | Teamwork.Read.All | 不可用。 |
HTTP 请求
GET /teamwork
请求标头
标头 | 值 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此方法在响应正文中返回响应 200 OK
代码以及 团队协作 对象。
注意
region 属性包含组织的 或用户的区域。 属性包含用户的区域 ((如果可用),) 具有有效多geo 许可证的用户。 对于没有多区域许可证的用户, 区域 属性包含组织的区域。
区域值可以是 Teams 有效负载支持的任何区域。 以下是可能的值:Americas、 欧洲和中东、亚太地区、阿联酋、澳大利亚、巴西、加拿大、瑞士、德国、法国、印度、日本、韩国、挪威、新加坡、英国、南非、瑞典、卡塔尔、波兰、意大利、以色列、USGov Community Cloud、USGov Community Cloud High、USGov 国防部、AG08 (USNAT) 、AG08 (USSEC) 和中国。
示例
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/v1.0/teamwork
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#teamwork",
"id": "teamwork",
"isTeamsEnabled": true,
"region": "Americas"
}
相关内容
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈