Тип ресурса targetedChatMessage

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет целевое сообщение в Microsoft Teams, которое отображается только указанному получателю. В отличие от обычных сообщений, которые видны всем участникам группового чата или канала, целевые сообщения обеспечивают конфиденциальность для взаимодействия с ботом и взаимодействия между пользователями, для которых требуется информация для конкретного пользователя.

Целевые сообщения используются в таких сценариях, как:

  • Бот запрашивает проверку подлинности в контекстах групп, где учетные данные должны быть видны только запрашивающим пользователям.
  • Сводки чата для новых участников, видимые только для присоединяющихся участников.
  • Упреждающие и реактивные сообщения бота, содержащие конфиденциальную информацию или сведения, относящиеся к конкретному пользователю.

Наследует от chatMessage.

Методы

Метод Тип возвращаемых данных Описание
Получение всех целевых сообщений targetedChatMessage collection Получение всех целевых сообщений , отправляемых конкретному пользователю в групповых чатах и каналах.
Получение всех сохраненных целевых сообщений targetedChatMessage collection Получение всех сохраненных целевых сообщений , отправляемых конкретному пользователю в групповых чатах и каналах.
Удаление целевого сообщения для канала Нет Удаление определенного целевого сообщения из контекста канала.
Удаление целевого сообщения для чата Нет Удаление определенного целевого сообщения из контекста чата.

Свойства

Свойство Тип Описание
attachments Коллекция chatMessageAttachment Ссылки на вложенные объекты, такие как файлы, вкладки, собрания или другие элементы. Наследуется от chatMessage.
body itemBody Содержимое сообщения. Наследуется от chatMessage.
channelIdentity channelIdentity Сведения о канале и команде, если целевое сообщение было отправлено в контексте канала. Содержит свойства channelId и teamId . Наследуется от chatMessage.
chatId String Уникальный идентификатор чата, если целевое сообщение было отправлено в контексте группового чата. Наследуется от chatMessage.
createdDateTime DateTimeOffset Дата и время создания сообщения. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, полночь в формате UTC 1 января 2014 г. имеет значение 2014-01-01T00:00:00Z. Наследуется от chatMessage.
deletedDateTime DateTimeOffset Дата и время удаления сообщения. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, полночь в формате UTC 1 января 2014 г. имеет значение 2014-01-01T00:00:00Z. Применимо только для сохраненных сообщений. Наследуется от chatMessage.
etag String Номер версии сообщения. Наследуется от chatMessage.
eventDetail eventMessageDetail Сведения о событии, если это сообщение представляет системное событие. Наследуется от chatMessage.
from chatMessageFromIdentitySet Сведения об отправителе целевого сообщения. Наследуется от chatMessage.
id String Уникальный идентификатор сообщения. Идентификатор сообщения уникален только в контексте одной беседы (чата или канала) для конкретного пользователя. Наследуется от chatMessage.
importance chatMessageImportance Важность сообщения. Допустимые значения: normal, high, urgent. Наследуется от chatMessage.
lastEdEdDateTime DateTimeOffset Дата и время последнего изменения сообщения. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, полночь в формате UTC 1 января 2014 г. имеет значение 2014-01-01T00:00:00Z. Наследуется от chatMessage.
lastModifiedDateTime DateTimeOffset Дата и время последнего изменения сообщения или любого из его свойств. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, полночь в формате UTC 1 января 2014 г. имеет значение 2014-01-01T00:00:00Z. Наследуется от chatMessage.
языковые стандарты String Языковой стандарт сообщения, заданный клиентом, в формате en-us. Наследуется от chatMessage.
mentions Коллекция 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.
reactions Коллекция chatMessageReaction Реакции, примененные к сообщению (например, например, сердце, смех). Наследуется от chatMessage.
получатель; identity Предполагаемый получатель целевого сообщения.
replyToId String Идентификатор родительского сообщения или корневого сообщения потока. Наследуется от chatMessage.
subject String Тема сообщения. Наследуется от chatMessage.
summary 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"
}