通道:存档
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
在团队中存档 频道 。 存档频道后,用户无法发送新消息或对频道中的现有消息做出反应、编辑频道设置或对通道进行其他更改。
可以删除已存档的频道,或在其中添加和删除成员。 如果存档团队,团队的频道将为你存档。
存档是异步的;异步存档操作成功完成后会存档通道,这可能会在响应返回后发生。
没有所有者或属于没有所有者的 组 的频道无法存档。
若要从其存档状态还原通道,请使用 unarchive 方法。 如果频道团队已存档,则无法存档或取消存档频道。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | ChannelSettings.ReadWrite.All | 不可用。 |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | ChannelSettings.ReadWrite.All | 不可用。 |
注意:此 API 支持管理员权限。 全局管理员和 Microsoft Teams 服务管理员可以访问自己不是其中成员的团队。
HTTP 请求
POST /teams/{team-id}/channels/{channel-id}/archive
POST /groups/{team-id}/team/channels/{channel-id}/archive
请求标头
标头 | 值 |
---|---|
Authorization | 持有者 {token}。 必填。 |
请求正文
在请求中,可以选择将 参数包含在 shouldSetSpoSiteReadOnlyForMembers
JSON 正文中,如下所示。
{
"shouldSetSpoSiteReadOnlyForMembers": true
}
此可选参数定义是否在与团队关联的 SharePoint Online 网站上将频道成员的权限设置为只读。 将其设置为 false 或完全省略正文会导致跳过此步骤。
响应
如果成功开始存档,此方法将返回一个 202 Accepted
响应代码。 响应包含一个 Location
标头,其中包含为处理团队中频道存档而创建的 teamsAsyncOperation 的位置。 可通过向此位置发出 GET 请求,查看存档操作的状态。
示例
示例 1:存档频道
以下示例演示了存档通道的请求。
请求
POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/archive
响应
以下示例显示了相应的响应。
HTTP/1.1 202 Accepted
Location: /teams/{team-id}/operations/{operation-id}
Content-Type: text/plain
Content-Length: 0
示例 2:存档团队时存档频道
以下示例演示存档 团队时的请求。
请求
POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/archive
响应
以下示例显示了 400
错误响应。
http/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 193
{
"error": {
"code": "BadRequest",
"message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",
"innerError": {
"message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",
"code": "Unknown",
"innerError": {},
"date": "2023-12-11T04:26:35",
"request-id": "8f897345980-f6f3-49dd-83a8-a3064eeecdf8",
"client-request-id": "50a0er33-4567-3f6c-01bf-04d144fc8bbe"
}
}
}
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈