命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
收到重新授权要求质询时 重新授权 订阅。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
权限
根据请求的资源和权限类型（委托或应用程序），下表中指定的权限为调用此 API 所需的最小权限。 若要了解其他信息， 在 特权权限之前要特别小心，在"权限" 中搜索。
注意
某些资源在多种方案中支持更改通知，其中每个方案可能需要不同的权限。 在这些情况下，请使用资源路径来区分方案。
| 支持的资源 | 委派（工作或学校帐户） | 委派（个人 Microsoft 帐户） | 应用程序 |
|---|---|---|---|
aiInteraction copilot/users/{userId}/interactionHistory/getAllEnterpriseInteractions 特定用户所属的 Copilot AI 交互。 |
AiEnterpriseInteraction.Read | 不支持。 | AiEnterpriseInteraction.Read.All、AiEnterpriseInteraction.Read.User |
aiInteraction copilot/interactionHistory/getAllEnterpriseInteractions 组织中的 Copilot AI 交互。 |
不支持。 | 不支持。 | AiEnterpriseInteraction.Read.All |
| 批准 | 不支持。 | 不支持。 | ApprovalSolution.ReadWrite.All |
| callRecord | 不支持。 | 不支持。 | CallRecords.Read.All |
callRecording communications/onlineMeetings/getAllRecordings 任何录制内容将在租户中可用。 |
不支持。 | 不支持。 | OnlineMeetingRecording.Read.All |
callRecording communications/onlineMeetings/{onlineMeetingId}/recordings 任何录制内容都可用于特定会议。 |
OnlineMeetingRecording.Read.All | 不支持。 | OnlineMeetingRecording.Read.All |
callRecording users/{userId}/onlineMeetings/getAllRecordings 在由特定用户组织的会议中可用的通话记录。 |
OnlineMeetingRecording.Read.All | 不支持。 | OnlineMeetingRecording.Read.All |
callRecording appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings 在安装了特定 Teams 应用的会议中可用的通话记录。 |
不支持。 | 不支持。 | OnlineMeetingRecording.Read.All、OnlineMeetingRecording.Read.Chat |
callTranscript communications/onlineMeetings/getAllTranscripts 任何脚本将在租户中可用。 |
不支持。 | 不支持。 | OnlineMeetingTranscript.Read.All |
callTranscript communications/onlineMeetings/{onlineMeetingId}/transcripts 任何脚本都可用于特定会议。 |
OnlineMeetingTranscript.Read.All | 不支持。 | OnlineMeetingTranscript.Read.All |
callTranscript users/{userId}/onlineMeetings/getAllTranscripts 在由特定用户组织的会议中可用的通话记录。 |
OnlineMeetingTranscript.Read.All | 不支持。 | OnlineMeetingTranscript.Read.All |
callTranscript appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts 在安装了特定 Teams 应用的会议中可用的通话记录。 |
不支持。 | 不支持。 | OnlineMeetingTranscript.Read.All、OnlineMeetingTranscript.Read.Chat |
频道 /teams/getAllChannels 组织中的所有频道。 |
不支持。 | 不支持。 | Channel.ReadBasic.All，ChannelSettings.Read.All |
频道 /teams/{id}/channels 组织中特定团队中的所有频道。 |
Channel.ReadBasic.All，ChannelSettings.Read.All | 不支持。 | Channel.ReadBasic.All，ChannelSettings.Read.All |
聊天 /chats 组织中的所有聊天。 |
不支持。 | 不支持。 | Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |
聊天 /chats/{id} 特定聊天。 |
Chat.ReadBasic, Chat.Read, Chat.ReadWrite | 不支持。 | ChatSettings.Read.Chat、ChatSettings.ReadWrite.Chat、Chat.Manage.Chat、Chat.ReadBasic.All、Chat.Read.All、Chat.ReadWrite.All |
聊天 /appCatalogs/teamsApps/{id}/installedToChats 安装了特定 Teams 应用的组织中所有聊天。 |
不支持。 | 不支持。 | Chat.ReadBasic.WhereInstalled、Chat.Read.WhereInstalled、Chat.ReadWrite.WhereInstalled |
聊天 /users/{id}/chats 特定用户参与的所有聊天。 |
Chat.ReadBasic, Chat.Read, Chat.ReadWrite | 不支持。 | Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |
chatMessage /teams/{id}/channels/{id}/messages 特定通道中的所有消息和答复。 |
ChannelMessage.Read.All、Group.Read.All、Group.ReadWrite.All | 不支持。 | ChannelMessage.Read.Group、ChannelMessage.Read.All |
chatMessage /teams/getAllMessages 组织中的所有频道消息。 |
不支持。 | 不支持。 | ChannelMessage.Read.All |
chatMessage /chats/{id}/messages 聊天中的所有消息。 |
Chat.Read、Chat.ReadWrite | 不支持。 | Chat.Read.All |
chatMessage /chats/getAllMessages 组织中的所有聊天消息。 |
不支持。 | 不支持。 | Chat.Read.All |
chatMessage /users/{id}/chats/getAllMessages 特定用户所属的所有聊天的聊天消息。 |
Chat.Read、Chat.ReadWrite | 不支持。 | Chat.Read.All、Chat.ReadWrite.All |
chatMessage /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages 安装特定 Teams 应用的组织中所有聊天的聊天消息。 |
不支持。 | 不支持。 | Chat.Read.WhereInstalled、Chat.ReadWrite.WhereInstalled |
| 联系人 | Contacts.Read | Contacts.Read | Contacts.Read |
conversationMember /chats/getAllMembers 组织中所有聊天的成员。 |
不支持。 | 不支持。 | ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All. |
conversationMember /chats/{id}/members 特定聊天的成员。 |
ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite | 不支持。 | ChatMember.Read.Chat、Chat.Manage.Chat、ChatMember.Read.All、ChatMember.ReadWrite.All、Chat.ReadBasic.All、Chat.Read.All、Chat.ReadWrite.All |
conversationMember /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers 安装特定 Teams 应用的组织中所有聊天的聊天成员。 |
不支持。 | 不支持。 | ChatMember.Read.WhereInstalled、ChatMember.ReadWrite.WhereInstalled、Chat.ReadBasic.WhereInstalled、Chat.Read.WhereInstalled、Chat.ReadWrite.WhereInstalled |
conversationMember /teams/getAllMembers 组织内所有团队的成员。 |
不支持。 | 不支持。 | TeamMember.Read.All, TeamMember.ReadWrite.All |
conversationMember /teams/{id}/members 特定团队中的成员。 |
TeamMember.Read.All | 不支持。 | TeamMember.Read.All |
conversationMember /teams/{id}/channels/getAllMembers 特定团队的所有私人频道的成员。 |
不支持。 | 不支持。 | ChannelMember.Read.All |
conversationMember /teams/getAllChannels/getAllMembers |
不支持。 | 不支持。 | ChannelMember.Read.All |
| driveItem（用户的个人 OneDrive） | 不支持。 | Files.ReadWrite | 不支持。 |
| driveItem (OneDrive for Business) | Files.ReadWrite.All | 不支持。 | Files.ReadWrite.All |
| 事件 | Calendars.Read | Calendars.Read | Calendars.Read |
| 组 | Group.Read.All | 不支持。 | Group.Read.All |
| 组对话 | Group.Read.All | 不支持。 | 不支持。 |
Microsoft Entra运行状况监视警报 /reports/healthmonitoring/alerts |
HealthMonitoringAlertConfig.ReadWrite.All | 不支持。 | HealthMonitoringAlertConfig.ReadWrite.All |
| 列表 | Sites.ReadWrite.All | 不支持。 | Sites.ReadWrite.All |
| 邮件 | Mail.ReadBasic、Mail.Read | Mail.ReadBasic、Mail.Read | Mail.Read |
offerShiftRequest /teams/{id}/schedule/offerShiftRequests 对团队中任何产品/服务转移请求的更改。 |
Schedule.Read.All、Schedule.ReadWrite.All | 不支持。 | Schedule.Read.All、Schedule.ReadWrite.All |
| 联机会议 | 不支持。 | 不支持。 | OnlineMeetings.Read.All、OnlineMeetings.ReadWrite.All |
openShiftChangeRequest /teams/{id}/schedule/openShiftChangeRequests 对团队中任何未结的班次请求的更改。 |
Schedule.Read.All、Schedule.ReadWrite.All | 不支持。 | Schedule.Read.All、Schedule.ReadWrite.All |
| 状态 | Presence.Read.All | 不支持。 | 不支持。 |
| 打印机 | 不支持。 | 不支持。 | 打印机。阅读.All，Printer.ReadWrite.All |
| printTaskDefinition | 不支持。 | 不支持。 | PrintTaskDefinition.ReadWrite.All |
| 安全警报 | SecurityEvents.ReadWrite.All | 不支持。 | SecurityEvents.ReadWrite.All |
shift /teams/{id}/schedule/shifts 对团队中任何班次的更改。 |
Schedule.Read.All、Schedule.ReadWrite.All | 不支持。 | Schedule.Read.All、Schedule.ReadWrite.All |
swapShiftsChangeRequest /teams/{id}/schedule/swapShiftsChangeRequests 对团队中任何交换班次请求的更改。 |
Schedule.Read.All、Schedule.ReadWrite.All | 不支持。 | Schedule.Read.All、Schedule.ReadWrite.All |
团队 /teams 组织中的所有团队。 |
不支持。 | 不支持。 | Team.ReadBasic.All，TeamSettings.Read.All |
团队 /teams/{id} 特定团队。 |
Team.ReadBasic.All，TeamSettings.Read.All | 不支持。 | Team.ReadBasic.All，TeamSettings.Read.All |
timeOffRequest /teams/{id}/schedule/timeOffRequests 对团队中任何休假请求的更改。 |
Schedule.Read.All、Schedule.ReadWrite.All | 不支持。 | Schedule.Read.All、Schedule.ReadWrite.All |
| todoTask | Tasks.ReadWrite | Tasks.ReadWrite | 不支持。 |
| user | User.Read.All | User.Read.All | User.Read.All |
| baseTask (已弃用) | Tasks.ReadWrite | Tasks.ReadWrite | 不支持。 |
注意
以下权限使用 特定于资源的许可：
- OnlineMeetingRecording.Read.Chat
- OnlineMeetingTranscript.Read.Chat
- ChatSettings.Read.Chat
- ChatSettings.ReadWrite.Chat
- Chat.Manage.Chat
- ChannelMessage.Read.Group
- ChatMember.Read.Chat
- AiEnterpriseInteraction.Read.User
chatMessage
可以将 chatMessage 订阅指定为包含资源数据 (includeResourceData 设置为 true) 。 在这种情况下，需要加密，如果未为此类订阅指定 encryptionCertificate ，则订阅创建会失败。
使用 Prefer: include-unknown-enum-members 请求标头在 chatMessagemessageType可进化枚举中获取以下值： systemEventMessage for /teams/{id}/channels/{id}/messages 和 /chats/{id}/messages resource。
注意
/teams/getAllMessages、 /chats/getAllMessages、 /me/chats/getAllMessages、 /users/{id}/chats/getAllMessages和 /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages 是按流量计费的 API; 付款模式和许可要求 可能适用。
/teams/getAllMessages和 /chats/getAllMessages 都支持 和 model=B 支付模型、/me/chats/getAllMessages、 /users/{id}/chats/getAllMessages和 /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages 仅model=B支持 。model=A
如果未在查询中指定付款模型，则使用默认 评估模式 。
注意
若要为已订阅的更改通知资源添加或更改付款模型，必须使用新的付款模型创建新的更改通知订阅;更新现有更改通知不起作用。
conversationMember
可以将 conversationMember 订阅指定为包含资源数据 (includeResourceData 设置为 true) 。 在这种情况下，需要加密，如果未为此类订阅指定 encryptionCertificate ，则订阅创建会失败。
注意
/teams/getAllMembers、 /chats/getAllMembers和 /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers 是按流量计费的 API; 付款模式和许可要求 可能适用。
/teams/getAllMembers 和 /chats/getAllMembers 都 model=A 支持 和 model=B 支付模型。
/appCatalogs/teamsApps/{id}/installedToChats/getAllMembers 仅 model=B支持 。
如果未在查询中指定付款模型，则使用默认 评估模式 。
注意
若要为已订阅的更改通知资源添加或更改付款模型，必须使用新的付款模型创建新的更改通知订阅;更新现有更改通知不起作用。
团队、频道和聊天
可以将团队、频道和聊天订阅指定为包含资源数据， (includeResourceData 设置为 true) 。 在这种情况下，需要加密，如果未为此类订阅指定 encryptionCertificate ，则订阅创建会失败。
订阅特定聊天或用户级别的更改时，可以使用 notifyOnUserSpecificProperties 查询字符串参数。 在创建订阅期间将查询字符串参数 notifyOnUserSpecificPropertiestrue 设置为 时，会将两种类型的有效负载发送到订阅服务器。 一种类型包含特定于用户的属性，另一种类型在发送时不使用它们。 有关详细信息，请参阅 使用 Microsoft Graph 获取聊天更改通知。
注意
若要为已订阅的更改通知资源添加或更改付款模型，必须使用新的付款模型创建新的更改通知订阅;更新现有更改通知不起作用。
请求示例
在请求正文中的 资源 内指定 model 查询参数。
POST https://graph.microsoft.com/v1.0/subscriptions
Content-type: application/json
{
"changeType": "created",
"notificationUrl": "https://webhook.azurewebsites.net/api/send/myNotifyClient",
"resource": "chats/getAllMessages?model=A",
"expirationDateTime":"2016-11-20T18:23:45.9356913Z",
"clientState": "secretClientValue",
"latestSupportedTlsVersion": "v1_2"
}
aiInteraction
Copilot AI 交互上的订阅需要有效的 Copilot 许可证，其中包括以下 Copilot 服务计划：
- 智能 Microsoft 365 Copilot 副驾驶® 对话助手：3f30311c-6b1e-48a4-ab79-725b469da960
对于面向特定用户所属的 Copilot AI 交互的订阅，资源路径中的用户必须具有以有效状态分配给他们的以前的服务计划。
对于面向整个租户的 Copilot AI 交互的订阅，租户必须预配了包含所有以前的 Copilot 服务计划的有效许可证。
HTTP 请求
POST /subscriptions/{subscriptionsId}/reauthorize
请求标头
| 名称 | 说明 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功，此操作返回 204 No Content 响应代码。
示例
请求
以下示例显示了一个请求。
POST https://graph.microsoft.com/beta/subscriptions/{subscriptionsId}/reauthorize
响应
以下示例显示了相应的响应。
HTTP/1.1 204 No Content