命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示Microsoft Teams 中仅对指定收件人可见的目标邮件。 与群聊或频道中的所有参与者可见的常规消息不同，定向消息为需要用户特定信息的机器人交互和应用到用户的通信提供了隐私。
目标消息用于以下方案：
- 组上下文中的机器人身份验证请求，其中凭据应仅对请求用户可见。
- 新成员的聊天摘要，仅对加入成员可见。
- 包含敏感或用户特定信息的主动和反应式机器人消息。
继承自 chatMessage。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 获取所有目标消息 | targetedChatMessage 集合 | 获取在群组聊天和频道中发送给特定用户的所有 目标消息 。 |
| 获取所有保留的目标消息 | targetedChatMessage 集合 | 在群组聊天和频道中获取发送给特定用户的所有保留 目标消息 。 |
| 删除通道的目标消息 | 无 | 从通道上下文中删除特定的 目标消息 。 |
| 删除聊天的目标消息 | 无 | 从聊天上下文中删除特定的 目标消息 。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 附件 | chatMessageAttachment 集合 | 对附加对象（如文件、选项卡、会议或其他项）的引用。 继承自 chatMessage。 |
| body | itemBody | 消息的内容。 继承自 chatMessage。 |
| channelIdentity | channelIdentity | 如果目标消息是在频道上下文中发送的，则为频道和团队信息。 包含 channelId 和 teamId 属性。 继承自 chatMessage。 |
| chatId | String | 如果目标消息是在群聊上下文中发送的，则聊天的唯一标识符。 继承自 chatMessage。 |
| createdDateTime | DateTimeOffset | 创建消息的日期和时间。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 继承自 chatMessage。 |
| deletedDateTime | DateTimeOffset | 删除邮件的日期和时间。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 仅适用于保留的消息。 继承自 chatMessage。 |
| etag | String | 消息的版本号。 继承自 chatMessage。 |
| eventDetail | eventMessageDetail | 如果此消息表示系统事件，则有关事件的详细信息。 继承自 chatMessage。 |
| 起始数量 | chatMessageFromIdentitySet | 有关目标邮件发件人的详细信息。 继承自 chatMessage。 |
| id | String | 消息的唯一标识符。 消息 ID 仅在单个对话 (聊天或频道) 特定用户的上下文中是唯一的。 继承自 chatMessage。 |
| importance | chatMessageImportance | 邮件的重要性。 可能的值包括 normal、high、urgent。 继承自 chatMessage。 |
| lastEditedDateTime | DateTimeOffset | 上次编辑邮件的日期和时间。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 继承自 chatMessage。 |
| lastModifiedDateTime | DateTimeOffset | 上次修改消息或其任何属性的日期和时间。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 继承自 chatMessage。 |
| 区域设置 | String | 客户端设置的消息的区域设置，格式为 en-us。 继承自 chatMessage。 |
| 提及 | chatMessageMention 集合 | 消息中提到的实体列表。 继承自 chatMessage。 |
| messageHistory | chatMessageHistoryItem 集合 | 应用于邮件的编辑历史记录。 继承自 chatMessage。 |
| messageType | chatMessageType | 邮件类型。 可能的值包括 message、chatEvent、typing、unknownFutureValue、systemEventMessage。 使用 Prefer: include-unknown-enum-members 请求标头从此 可演变枚举中获取以下值： systemEventMessage。 继承自 chatMessage。 |
| onBehalfOf | chatMessageFromIdentitySet | 有关代表其发送消息的用户的信息。 继承自 chatMessage。 |
| policyViolation | chatMessagePolicyViolation | 有关数据丢失防护 (DLP) 应用程序应用于消息的策略冲突的信息。 继承自 chatMessage。 |
| 反应 | chatMessageReaction 集合 | 应用于消息的反应 (，例如，心，笑) 。 继承自 chatMessage。 |
| recipient | identity | 目标邮件的目标收件人。 |
| replyToId | String | 线程的父消息或根消息的 ID。 继承自 chatMessage。 |
| subject | String | 邮件的主题。 继承自 chatMessage。 |
| 摘要 | String | 可用于通知或摘要视图的邮件的摘要文本。 继承自 chatMessage。 |
| webUrl | String | 指向 Microsoft Teams 中消息的链接。 继承自 chatMessage。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| hostedContents | chatMessageHostedContent 集合 | 消息中托管的内容，例如图像或代码片段。 继承自 chatMessage。 |
| 答复 | chatMessage 集合 | 答复邮件。 目前不支持目标消息。 继承自 chatMessage。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.targetedChatMessage",
"attachments": [{"@odata.type": "microsoft.graph.chatMessageAttachment"}],
"body": {"@odata.type": "microsoft.graph.itemBody"},
"channelIdentity": {"@odata.type": "microsoft.graph.channelIdentity"},
"chatId": "String",
"createdDateTime": "String (timestamp)",
"deletedDateTime": "String (timestamp)",
"etag": "String",
"eventDetail": {"@odata.type": "microsoft.graph.eventMessageDetail"},
"from": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
"id": "String (identifier)",
"importance": "String",
"lastEditedDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"locale": "String",
"mentions": [{"@odata.type": "microsoft.graph.chatMessageMention"}],
"messageHistory": [{"@odata.type": "microsoft.graph.chatMessageHistoryItem"}],
"messageType": "String",
"onBehalfOf": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
"policyViolation": {"@odata.type": "microsoft.graph.chatMessagePolicyViolation"},
"reactions": [{"@odata.type": "microsoft.graph.chatMessageReaction"}],
"recipient": {"@odata.type": "microsoft.graph.identity"},
"replyToId": "String",
"subject": "String",
"summary": "String",
"webUrl": "String"
}