chatMessage 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示 渠道或聊天中的单个聊天信息。 该消息可以是根消息，也可以是消息中的 replyToId 属性定义的线程部分。

注意：此资源支持使用 更改通知订阅更改 (创建、更新和删除) 。 这使呼叫方可以实时订阅和获取更改。 有关详细信息，请参阅获取消息通知。

方法

方法	返回类型	说明
频道消息
在通道中列出消息	chatMessage 集合	通道中所有根消息的列表。
获取通道中消息的增量	chatMessage	获取频道中的增量消息。
创建新频道消息的订阅	订阅	侦听新的、编辑的和已删除的消息，以及对它们的反应。
在频道中获取消息	chatMessage	获取通道中的单个根消息。
在通道中发送消息	chatMessage	在通道中创建新的根消息。
在通道中更新消息	chatMessage	更新聊天消息的 policyViolation 属性。
删除通道中的消息	chatMessage	删除频道中的消息。
撤消通道中邮件的删除	chatMessage	取消删除频道中的消息。
频道消息回复
列出对邮件的答复	chatMessage 集合	频道中对聊天消息的所有答复的列表。
在频道中获取回复消息	chatMessage	在频道中获取一条回复消息。
在频道中回复消息	chatMessage	回复频道中的现有聊天消息。
更新回复消息	chatMessage	更新聊天消息的 policyViolation 属性。
删除频道中的回复消息	chatMessage	删除频道中的单个回复消息。
撤消通道中回复消息的删除	chatMessage	取消删除频道中的单个回复消息。
聊天消息
列出聊天中的消息	chatMessage	列出聊天中的聊天消息。
获取聊天中的消息	chatMessage	在聊天中获取一条聊天消息。
为用户在所有聊天中获取消息	聊天 集合	从用户参与的所有聊天中获取消息，包括 1：1 聊天、群聊和会议聊天。
获取所有频道消息	channel 集合	获取用户参与的所有频道中的所有消息。
创建新聊天消息的订阅	订阅	侦听新的、编辑的和已删除的聊天消息，以及对它们的反应。
在聊天中发送消息	chatMessage	在现有 1：1 或群组聊天对话中发送聊天消息。
在聊天中更新消息	chatMessage	更新聊天消息的 policyViolation 属性。
删除聊天中的消息	chatMessage	删除聊天消息。
撤消聊天中邮件的删除	chatMessage	在聊天中取消删除消息。
托管内容
列出所有托管内容	chatMessageHostedContent 集合	获取与消息关联的所有托管内容。
获取托管内容	chatMessageHostedContent	获取邮件的托管内容 (及其字节) 。

属性

属性	类型	说明
attachments	chatMessageAttachment 集合	对文件、选项卡、会议等附加对象的引用。
body	itemBody	聊天消息内容的纯文本/HTML 表示形式。 表示形式由正文中的 contentType 进行指定。 如果聊天消息包含 chatMessageMention，则内容始终采用 HTML。
channelIdentity	channelIdentity	如果消息是在通道中发送的，则表示通道的标识。
chatId	string	如果消息是在 聊天 中发送的，则表示 聊天 的标识。
createdDateTime	dateTimeOffset	创建聊天消息的时间戳。
deletedDateTime	dateTimeOffset	只读。 删除聊天消息的时间戳，如果未删除，则为 null。
etag	string	只读。 聊天消息的版本号。
eventDetail	eventMessageDetail	只读。 如果存在，则表示 聊天、 频道 或 团队 中发生的事件的详细信息，例如添加新成员。 对于事件消息， messageType 属性将设置为 systemEventMessage。
起始数量	chatMessageFromIdentitySet	聊天消息的发件人详细信息。 只能在 迁移期间设置。
id	String	只读。 消息的唯一 ID。
importance	string	聊天消息的重要性。 可能的值包括 normal、high、urgent。
lastEditedDateTime	dateTimeOffset	只读。 对聊天消息进行编辑时的时间戳。 在 Teams UI 中触发“编辑”标志。 如果未进行任何编辑，则值为 null。
lastModifiedDateTime	dateTimeOffset	只读。 创建聊天消息时的时间戳 (初始设置) 或修改，包括添加或删除反应的时间。
区域设置	string	客户端设置的聊天消息的区域设置。 始终设置为 en-us。
提及	chatMessageMention 集合	聊天消息中提到的实体列表。 支持的实体包括：用户、机器人、团队、频道和标记。
messageType	chatMessageType	聊天消息的类型。 可能的值包括 message、chatEvent、typing、unknownFutureValue、systemEventMessage。 请注意，必须使用 Prefer: include-unknown-enum-members 请求标头获取此 可进化枚举 中的以下值: systemEventMessage。
onBehalfOf	chatMessageFromIdentitySet	机器人代表用户发送消息时消息的用户归属。
policyViolation	chatMessagePolicyViolation	定义由数据丢失防护设置的策略冲突的属性 (DLP) 应用程序。
反应	chatMessageReaction 集合	此聊天消息的反应 (如) 。
replyToId	string	只读。 线程的父聊天消息或根聊天消息的 ID。 (仅适用于频道中的聊天消息，而不适用于聊天。)
subject	string	聊天消息的主题，用纯文本表示。
摘要	string	可用于推送通知和摘要视图或回退视图的聊天消息的摘要文本。 仅适用于频道聊天消息，而不适用于聊天中的聊天消息。
webUrl	string	只读。 链接到 Microsoft Teams 中的消息。

关系

关系	类型	说明
答复	chatMessage	针对指定消息的答复。 支持 $expand 通道消息。
hostedContents	chatMessageHostedContent	Microsoft Teams 托管的消息中的内容 -例如，图像或代码片段。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "id": "string (identifier)",
  "replyToId": "string (identifier)",
  "from": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
  "etag": "string",
  "messageType": "string",
  "createdDateTime": "string (timestamp)",
  "lastModifiedDateTime": "string (timestamp)",
  "lastEditedDateTime": "string (timestamp)",
  "deletedDateTime": "string (timestamp)",
  "subject": "string",
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "summary": "string",
  "attachments": [{"@odata.type": "microsoft.graph.chatMessageAttachment"}],
  "mentions": [{"@odata.type": "microsoft.graph.chatMessageMention"}],
  "onBehalfOf": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
  "importance": "string",
  "reactions": [{"@odata.type": "microsoft.graph.chatMessageReaction"}],
  "locale": "string",
  "policyViolation": {"@odata.type": "microsoft.graph.chatMessagePolicyViolation"},
  "chatId": "string",
  "channelIdentity": {"@odata.type": "microsoft.graph.channelIdentity"},
  "webUrl": "string",
  "eventDetail": {
    "@odata.type": "microsoft.graph.eventMessageDetail"
  }
}