Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: 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"
}