Ressourcentyp erwähnenmention resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Stellt eine Benachrichtigung an eine Person dar, die auf der e-Mail-Adresse der Person basiert.Represents a notification to a person based on the person's email address. Diese Art von Benachrichtigung wird auch als @-Mentions bezeichnet.This type of notification is also known as @-mentions.

Die Nachricht Ressource unter **** stützt Erwähnung.The message resource supports mention. Sie enthält eine mentionsPreview -Eigenschaft, die angibt, ob der angemeldete Benutzer in dieser Nachrichteninstanz erwähnt wird.It includes a mentionsPreview property that indicates whether the signed-in user is mentioned in that message instance. Sie enthält auch die Mentions -Navigationseigenschaft, die das erhalten von Details zu einer Erwähnung oder das Löschen einer Erwähnung in dieser Instanz unterstützt.It also includes the mentions navigation property, which supports getting details of a mention, or deleting a mention in that instance.

Beim Erstellen einer Nachricht kann eine APP eine Erwähnung in derselben POST Anforderung erstellen, indem Sie die Erwähnung in der Mentions -Eigenschaft einschließt.When creating a message, an app can create a mention in the same POST request by including the mention in the mentions property. Mithilfe einer GET Anforderung mit dem $filter Abfrageparameter kann eine APP alle Nachrichten im Postfach des angemeldeten Benutzers zurückgeben, in denen der Benutzer erwähnt wird.Using a GET request with the $filter query parameter, an app can return all the messages in the signed-in user's mailbox that mention the user. Eine GET Anforderung mit dem $expand Abfrageparameter ermöglicht es der APP, alle Erwähnungen in einer bestimmten Nachricht zu erweitern.A GET request with the $expand query parameter lets the app expand all mentions in a specific message.

Dieser Mechanismus, mit dem eine APP festgelegt und in Nachrichten erwähnt wird, ermöglicht einfache Benachrichtigungen, bei denen der Benutzer, der die Erwähnung vornimmt, im vorhandenen Kontext bleiben kann (beispielsweise beim Verfassen eines **** Nachrichtentexts), während die APP die zugrunde liegende Mentions-Eigenschaft festlegt. .This mechanism of letting an app set and get mentions in messages enables lightweight notifications, where the user making the mention can remain in the existing context (such as composing a message body) while the app sets the underlying mentions property. Erwähnte Personen können leicht herausfinden, ob und wo Sie durch GET Anforderungen mit dem $filter or $expand -Abfrageparameter erwähnt werden.Mentioned persons can easily find out if and where they are mentioned through GET requests with the $filter or $expand query parameter.

Wenn ein Benutzer @ beispielsweise im Outlook-e-Mail-Client eine Nachricht schreibt, ermöglicht Outlook dem Benutzer die Auswahl oder Eingabe eines Namens, um die @-Erwähnung abzuschließen.For example, in the Outlook mail client, when a user types @ while writing a message, Outlook lets the user select or enter a name to complete the @-mention. Outlook legt die Mentions -Eigenschaft fest, bevor die Nachricht oder das Ereignis erstellt und gesendet wird.Outlook sets the mentions property before it creates and sends the message or event. Outlook verwendet GET auch Vorgänge mit $filter und $expand , um den angemeldeten Benutzer Nachrichten nachzuschlagen, die den Benutzer erwähnen, und den Benutzer über Aktionselemente oder Diskussionen zu informieren, was eine schnellere Reaktion ermöglicht.Outlook also uses GET operations with $filter and $expand to let the signed-in user look up messages that mention the user, alerting the user to action items or discussions, which allows for a faster response.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.

{
  "application": "string",
  "clientReference": "string",
  "createdBy": {"@odata.type": "microsoft.graph.emailAddress"},
  "createdDateTime": "DateTimeOffset",
  "deepLink": "string",
  "id": "string (identifier)",
  "mentioned": {"@odata.type": "microsoft.graph.emailAddress"},
  "mentionText": "string",
  "serverCreatedDateTime": "DateTimeOffset"
}

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
Anwendungapplication ZeichenfolgeString Der Name der Anwendung, in der die Erwähnung erstellt wird.The name of the application where the mention is created. Optional.Optional. Nicht verwendet und als NULL für Nachrichtstandardmäßig.Not used and defaulted as null for message.
clientReferenceclientReference ZeichenfolgeString Ein eindeutiger Bezeichner, der ein übergeordnetes Element der Ressourceninstanz darstellt.A unique identifier that represents a parent of the resource instance. Optional.Optional. Nicht verwendet und als NULL für Nachrichtstandardmäßig.Not used and defaulted as null for message.
createdBycreatedBy emailAddressemailAddress Die e-Mail-Informationen des Benutzers, der die Erwähnung vorgenommen hat.The email information of the user who made the mention.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit der Erstellung der Erwähnung auf dem Client.The date and time that the mention is created on the client.
deepLinkdeepLink ZeichenfolgeString Eine Tiefe Webverknüpfung mit dem Kontext der Erwähnung in der Ressourceninstanz.A deep web link to the context of the mention in the resource instance. Optional.Optional. Nicht verwendet und als NULL für Nachrichtstandardmäßig.Not used and defaulted as null for message.
idid ZeichenfolgeString Der eindeutige Bezeichner einer Erwähnung in einer Ressourceninstanz.The unique identifier of a mention in a resource instance.
erwähntmentioned emailAddressemailAddress Die e-Mail-Informationen der genannten Person.The email information of the mentioned person. Erforderlich.Required.
mentionTextmentionText StringString Optional.Optional. Nicht verwendet und als NULL für Nachrichtstandardmäßig.Not used and defaulted as null for message. Wenn Sie die Erwähnungen in einer Nachricht erhalten möchten, lesen Sie stattdessen die bodyPreview -Eigenschaft der Nachricht.To get the mentions in a message, see the bodyPreview property of the message instead.
serverCreatedDateTimeserverCreatedDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit der Erstellung der Erwähnung auf dem Server.The date and time that the mention is created on the server. Optional.Optional. Nicht verwendet und als NULL für Nachrichtstandardmäßig.Not used and defaulted as null for message.

BeziehungenRelationships

KeineNone

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Veröffentlichen und sendenPost and send KeineNone Erstellen und Senden von Erwähnungen als Teil einer neuen Nachricht.Create and send mentions as part of a new message.
Beitrag in einem neuen EntwurfPost to a new draft Nachricht , die ein oder mehrere mention -Objekte enthält.message that contains one or more mention objects. Erstellen Sie einen Entwurf einer neuen Nachricht, und schließen Sie ein oder mehrere mention -Objekte ein.Create a draft of a new message and include one or more mention objects.
Nachrichten, die mich erwähnenGet messages mentioning me message-Sammlungmessage collection Rufen Sie alle Nachrichten im Postfach des angemeldeten Benutzers ab, die **** eine Erwähnung dieses Benutzers enthalten.Get all the messages in the signed-in user's mailbox that contain a mention of this user.
Erhalten einer Nachricht und ihrer ErwähnungenGet a message and its mentions message-Sammlungmessage collection Rufen Sie eine Nachricht ab, und erweitern Sie **** die Details jeder Erwähnung in der Nachricht.Get a message and expand the details of each mention in the message.
Löschen einer ErwähnungDelete a mention KeineNone Löscht die angegebene Erwähnung in der angegebenen Nachricht im Postfach des angemeldeten Benutzers.Deletes the specified mention in the specified message in the signed-in user's mailbox.