Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Représente un message ciblé dans Microsoft Teams qui n’est visible que par un destinataire spécifié. Contrairement aux messages standard qui sont visibles par tous les participants d’une conversation ou d’un canal de groupe, les messages ciblés offrent une confidentialité pour les interactions avec les bots et les communications application-utilisateur qui nécessitent des informations spécifiques à l’utilisateur.
Les messages ciblés sont utilisés dans les scénarios suivants :
- Demandes d’authentification de bot dans des contextes de groupe, où les informations d’identification doivent être visibles uniquement par l’utilisateur demandeur.
- Résumés des chats pour les nouveaux membres, visibles uniquement par le membre qui les rejoint.
- Messages de bot proactifs et réactifs qui contiennent des informations sensibles ou spécifiques à l’utilisateur.
Hérite de chatMessage.
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| Obtenir tous les messages ciblés | collecte targetedChatMessage | Obtenez tous les messages ciblés envoyés à un utilisateur spécifique dans les conversations de groupe et les canaux. |
| Obtenir tous les messages ciblés retenus | collecte targetedChatMessage | Obtenez tous les messages ciblés retenus envoyés à un utilisateur spécifique dans des conversations de groupe et des canaux. |
| Supprimer le message ciblé du canal | Aucun | Supprimez un message ciblé spécifique d’un contexte de canal. |
| Supprimer le message ciblé de la conversation | Aucun | Supprimez un message ciblé spécifique d’un contexte de conversation. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| pièces jointes | collectionchatMessageAttachment | Références à des objets joints tels que des fichiers, des onglets, des réunions ou d’autres éléments. Hérité de chatMessage. |
| corps | itemBody | Le contenu du message. Hérité de chatMessage. |
| channelIdentity | channelIdentity | Les informations sur le canal et l’équipe si le message ciblé a été envoyé dans un contexte de canal. Contient les propriétés channelId et teamId . Hérité de chatMessage. |
| chatId | String | Identifiant unique de la conversation si le message ciblé a été envoyé dans un contexte de conversation de groupe. Hérité de chatMessage. |
| createdDateTime | DateTimeOffset | Date et heure de création du message. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2014 est 2014-01-01T00:00:00Z. Hérité de chatMessage. |
| deletedDateTime | DateTimeOffset | Date et heure de suppression du message. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2014 est 2014-01-01T00:00:00Z. Applicable uniquement pour les messages conservés. Hérité de chatMessage. |
| etag | String | Numéro de version du message. Hérité de chatMessage. |
| Détail événement | eventMessageDetail | Détails sur l’événement si ce message représente un événement système. Hérité de chatMessage. |
| from | chatMessageFromIdentitySet | Détails sur l’expéditeur du message ciblé. Hérité de chatMessage. |
| id | String | Identifiant unique du message. L’ID de message est unique uniquement dans le contexte d’une conversation unique (conversation ou canal) pour un utilisateur spécifique. Hérité de chatMessage. |
| importance | chatMessageImportance | L’importance du message. Les valeurs possibles sont : normal, high, urgent, unknownFutureValue. Hérité de chatMessage. |
| lastEditedDateTime | DateTimeOffset | Date et heure de la dernière modification du message. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2014 est 2014-01-01T00:00:00Z. Hérité de chatMessage. |
| lastModifiedDateTime | DateTimeOffset | Date et heure de la dernière modification du message ou de l’une de ses propriétés. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2014 est 2014-01-01T00:00:00Z. Hérité de chatMessage. |
| local | String | Paramètres régionaux du message définis par le client, au format .en-us Hérité de chatMessage. |
| mentions | collectionchatMessageMention | Liste des entités mentionnées dans le message. Hérité de chatMessage. |
| Historique des messages | chatMessageHistoryItem collection | Historique des modifications appliquées au message. Hérité de chatMessage. |
| messageType | chatMessageType | Type du message. Les valeurs possibles sont : message, chatEvent, typing, unknownFutureValue, systemEventMessage. Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes à partir de cette énumération évolutive : systemEventMessage. Hérité de chatMessage. |
| onBehalfOf | chatMessageFromIdentitySet | Informations sur l’utilisateur au nom duquel le message a été envoyé. Hérité de chatMessage. |
| policyViolation | chatMessagePolicyViolation | Informations sur les violations de stratégie appliquées au message par les applications de protection contre la perte de données (DLP). Hérité de chatMessage. |
| réactions | collectionchatMessageReaction | Les réactions appliquées au message (par exemple, J’aime, Cœur et Rire). Hérité de chatMessage. |
| destinataire | identity | Destinataire prévu du message ciblé. |
| replyToId | String | ID du message parent ou du message racine du thread. Hérité de chatMessage. |
| sujet | String | Objet du message. Hérité de chatMessage. |
| résumé | String | Texte de synthèse du message qui peut être utilisé pour les notifications ou les affichages de synthèse. Hérité de chatMessage. |
| webUrl | String | Lien vers le message dans Microsoft Teams. Hérité de chatMessage. |
Relations
| Relation | Type | Description |
|---|---|---|
| hostedContents | collection chatMessageHostedContent | Contenu hébergé dans le message, comme des images ou des extraits de code. Hérité de chatMessage. |
| Réponses | collectionchatMessage | Réponses au message. Actuellement non pris en charge pour les messages ciblés. Hérité de chatMessage. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@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"
}