chatMessage 资源类型

命名空间:microsoft.graph

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

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

方法

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

属性

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

关系

关系 类型 说明
答复 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"}],
  "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"
  }
}