targetedChatMessage-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt eine Zielnachricht in Microsoft Teams dar, die nur für einen angegebenen Empfänger sichtbar ist. Im Gegensatz zu regulären Nachrichten, die für alle Teilnehmer an einem Gruppenchat oder Kanal sichtbar sind, bieten gezielte Nachrichten Datenschutz für Botinteraktionen und Die Kommunikation zwischen Apps und Benutzern, die benutzerspezifische Informationen erfordern.

Zielnachrichten werden in Folgenden Szenarien verwendet:

• Botauthentifizierungsanforderungen in Gruppenkontexten, in denen Anmeldeinformationen nur für den anfordernden Benutzer sichtbar sein sollten.
• Chatzusammenfassungen für neue Mitglieder, die nur für das beitretende Mitglied sichtbar sind.
• Proaktive und reaktive Botnachrichten, die vertrauliche oder benutzerspezifische Informationen enthalten.

Erbt von chatMessage.

Methoden

Methode	Rückgabetyp	Beschreibung
Abrufen aller Zielnachrichten	targetedChatMessage-Sammlung	Abrufen aller Zielnachrichten , die an einen bestimmten Benutzer in Gruppenchats und -kanälen gesendet werden.
Abrufen aller beibehaltenen Zielnachrichten	targetedChatMessage-Sammlung	Abrufen aller beibehaltenen Zielnachrichten , die in Gruppenchats und -kanälen an einen bestimmten Benutzer gesendet werden.
Löschen der Zielnachricht für den Kanal	Keine	Löschen einer bestimmten Zielnachricht aus einem Kanalkontext.
Löschen einer Zielnachricht für den Chat	Keine	Löschen einer bestimmten Zielnachricht aus einem Chatkontext.

Eigenschaften

Eigenschaft	Typ	Beschreibung
Anlagen	chatMessageAttachment-Sammlung	Verweise auf angefügte Objekte wie Dateien, Registerkarten, Besprechungen oder andere Elemente. Geerbt von chatMessage.
body	itemBody	Der Inhalt der Nachricht. Geerbt von chatMessage.
channelIdentity	channelIdentity	Die Kanal- und Teaminformationen, wenn die Zielnachricht in einem Kanalkontext gesendet wurde. Enthält die Eigenschaften channelId und teamId . Geerbt von chatMessage.
chatId	Zeichenfolge	Der eindeutige Bezeichner des Chats, wenn die Zielnachricht in einem Gruppenchatkontext gesendet wurde. Geerbt von chatMessage.
createdDateTime	DateTimeOffset	Das Datum und die Uhrzeit der Erstellung der Nachricht. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Zbeispielsweise . Geerbt von chatMessage.
deletedDateTime	DateTimeOffset	Das Datum und die Uhrzeit des Löschens der Nachricht. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Zbeispielsweise . Gilt nur für beibehaltene Nachrichten. Geerbt von chatMessage.
etag	Zeichenfolge	Versionsnummer der Nachricht. Geerbt von chatMessage.
eventDetail	eventMessageDetail	Details zum Ereignis, wenn diese Meldung ein Systemereignis darstellt. Geerbt von chatMessage.
von	chatMessageFromIdentitySet	Details zum Absender der Zielnachricht. Geerbt von chatMessage.
id	Zeichenfolge	Eindeutiger Bezeichner der Nachricht. Die Nachrichten-ID ist nur im Kontext einer einzelnen Unterhaltung (Chat oder Kanal) für einen bestimmten Benutzer eindeutig. Geerbt von chatMessage.
Wichtigkeit	chatMessageImportance	Die Wichtigkeit der Nachricht. Die möglichen Werte sind: normal, high, urgent. Geerbt von chatMessage.
lastEditedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Bearbeitung der Nachricht. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Zbeispielsweise . Geerbt von chatMessage.
lastModifiedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Änderung der Nachricht oder einer ihrer Eigenschaften. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Zbeispielsweise . Geerbt von chatMessage.
Gebietsschema	Zeichenfolge	Das Vom Client festgelegte Gebietsschema der Nachricht, formatiert als en-us. Geerbt von chatMessage.
Erwähnungen	chatMessageMention-Sammlung	Liste der Entitäten, die in der Nachricht angegeben werden. Geerbt von chatMessage.
messageHistory	chatMessageHistoryItem-Auflistung	Verlauf der änderungen, die auf die Nachricht angewendet wurden. Geerbt von chatMessage.
messageType	chatMessageType	Der Typ der Nachricht. Mögliche Werte sind: message, chatEvent, typing, unknownFutureValue, systemEventMessage. Verwenden Sie den Anforderungsheader Prefer: include-unknown-enum-members , um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: systemEventMessage. Geerbt von chatMessage.
onBehalfOf	chatMessageFromIdentitySet	Informationen zum Benutzer, in dessen Auftrag die Nachricht gesendet wurde. Geerbt von chatMessage.
policyViolation	chatMessagePolicyViolation	Informationen zu Richtlinienverstößen, die von DLP-Anwendungen (Data Loss Prevention, Verhinderung von Datenverlust) auf die Nachricht angewendet werden. Geerbt von chatMessage.
Reaktionen	chatMessageReaction-Sammlung	Die Reaktionen, die auf die Nachricht angewendet werden (z. B. Herz, Lachen). Geerbt von chatMessage.
recipient	identity	Der beabsichtigte Empfänger der Zielnachricht.
replyToId	Zeichenfolge	Die ID der übergeordneten Nachricht oder Stammnachricht des Threads. Geerbt von chatMessage.
subject	String	Der Betreff der Nachricht. Geerbt von chatMessage.
Zusammenfassung	Zeichenfolge	Zusammenfassungstext der Nachricht, der für Benachrichtigungen oder Zusammenfassungsansichten verwendet werden kann. Geerbt von chatMessage.
webUrl	Zeichenfolge	Der Link zur Nachricht in Microsoft Teams. Geerbt von chatMessage.

Beziehungen

Beziehung	Typ	Beschreibung
hostedContents	chatMessageHostedContent-Sammlung	In der Nachricht gehostete Inhalte, z. B. Bilder oder Codeausschnitte. Geerbt von chatMessage.
Antworten	chatMessage-Auflistung	Antworten auf die Nachricht. Derzeit nicht für Zielnachrichten unterstützt. Geerbt von chatMessage.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@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"
}