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 gezielte Nachricht in Microsoft Teams dar, die nur für einen bestimmten Empfänger sichtbar ist. Im Gegensatz zu normalen Nachrichten, die für alle Teilnehmer in einem Gruppenchat oder Kanal sichtbar sind, bieten gezielte Nachrichten Privatsphäre für Botinteraktionen und App-zu-Benutzer-Kommunikationen, die benutzerspezifische Informationen erfordern.

Gezielte Nachrichten werden in Szenarien wie diesen verwendet:

• Robot-Authentifizierungsanfragen in Gruppenkontexten, in denen Anmeldeinformationen nur für den anfordernden Benutzer sichtbar sein sollten.
• Chat-Zusammenfassungen für neue Mitglieder, nur für das beitretende Mitglied sichtbar.
• Proaktive und reaktive Bot-Nachrichten, die sensible oder benutzerspezifische Informationen enthalten.

Erbt von chatMessage.

Methoden

Methode	Rückgabetyp	Beschreibung
Abrufen aller gezielten Nachrichten	targetedChatMessage-Sammlung	Abrufen aller gezielten Nachrichten , die an einen bestimmten Benutzer in Gruppenchats und Kanälen gesendet werden.
Abrufen aller aufbewahrten gezielten Nachrichten	targetedChatMessage-Sammlung	Abrufen aller aufbewahrten gezielten Nachrichten , die an einen bestimmten Benutzer in Gruppenchats und Kanälen gesendet wurden.
Gezielte Nachricht aus Kanal löschen	Keine	Löschen Sie eine bestimmte zielgerichtete Nachricht aus einem Kanalkontext.
Gezielte Nachricht aus Chat löschen	Keine	Löschen Sie eine bestimmte zielgerichtete Nachricht 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 gezielte Nachricht in einem Kanalkontext gesendet wurde. Enthält die Eigenschaften channelId und teamId . Geerbt von chatMessage.
chatId	Zeichenfolge	Der eindeutige Bezeichner des Chats, wenn die gezielte Nachricht in einem Gruppenchatkontext gesendet wurde. Geerbt von chatMessage.
createdDateTime	DateTimeOffset	Das Datum und die Uhrzeit, zu der die Nachricht erstellt wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel ist Mitternacht UTC am 1. Januar 2014 .2014-01-01T00:00:00Z Geerbt von chatMessage.
deletedDateTime	DateTimeOffset	Das Datum und die Uhrzeit, zu der die Nachricht gelöscht wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel ist Mitternacht UTC am 1. Januar 2014 .2014-01-01T00:00:00Z Gilt nur für aufbewahrte 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 über den 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. Mögliche Werte sind: normal, high, urgent, unknownFutureValue. Geerbt von chatMessage.
lastEditedDateTime	DateTimeOffset	Datum und Uhrzeit, wann die Nachricht zuletzt bearbeitet wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel ist Mitternacht UTC am 1. Januar 2014 .2014-01-01T00:00:00Z Geerbt von chatMessage.
lastModifiedDateTime	DateTimeOffset	Datum und Uhrzeit, zu dem die Nachricht oder eine ihrer Eigenschaften zuletzt geändert wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel ist Mitternacht UTC am 1. Januar 2014 .2014-01-01T00:00:00Z Geerbt von chatMessage.
Gebietsschema	Zeichenfolge	Das Gebietsschema der Nachricht, wie es vom Client festgelegt wurde, 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 auf die Nachricht angewendeten Änderungen. Geerbt von chatMessage.
messageType	chatMessageType	Der Typ der Nachricht. Mögliche Werte sind: message, chatEvent, typing, unknownFutureValue, systemEventMessage. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte aus dieser entwicklungsfähigen Aufzählung zu erhalten: systemEventMessage. Geerbt von chatMessage.
onBehalfOf	chatMessageFromIdentitySet	Informationen über den Benutzer, in dessen Auftrag die Nachricht gesendet wurde. Geerbt von chatMessage.
policyViolation	chatMessagePolicyViolation	Informationen zu Richtlinienverletzungen, die durch Anwendungen zur Verhinderung von Datenverlust (Data Loss Prevention, DLP) auf die Nachricht angewendet werden. Geerbt von chatMessage.
Reaktionen	chatMessageReaction-Sammlung	Die auf die Nachricht angewendeten Reaktionen (z. B. "Wie", "Herz" und "Lachen"). Geerbt von chatMessage.
recipient	identity	Der beabsichtigte Empfänger der adressierten Nachricht.
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	Antwortet auf die Nachricht. Derzeit wird es für gezielte Nachrichten nicht 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"
}