chatMessageMention-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 Erwähnung in einer chatMessage-Entität dar. Die Erwähnung kann sich auf einen Benutzer, ein Team, einen Bot, einen Kanal oder einen Chat beziehen.

In einem chatMessage-Objekt , das eine oder mehrere Erwähnungen enthält, stellt die Inhaltseigenschaft Nachrichtentext die Chatnachricht in HTML dar. Sie schließt den mentionText jeder Erwähnung in ein HTML-Element at ein, mit einem id Attribut, das der id-Eigenschaft der Erwähnung entspricht.

Beispielsweise enthält eine Chatnachricht zwei Erwähnungen mit dem Erwähnungstext "Megan" bzw. "Alex". Die body-content-Eigenschaft gibt Elemente für die beiden Erwähnungen wie folgt an at :

"body": {
    "contentType": "html",
    "content": "<div><div>Ah, <at id=\"0\">Megan</at>, <at id=\"1\">Alex</at>, I saw them in a separate folder. Thanks!</div>\n</div>"
}

In der content-Eigenschaft hat die erste Erwähnung ein HTML-Attribut id von 0. Dies entspricht der id-Eigenschaft der ersten Instance von chatMessageMention, die ebenfalls 0 ist.

Die zweite Erwähnung verfügt über ein id Attribut von 1, das der id-Eigenschaft der zweiten instance entspricht, die 1 ist.

Einen ausführlicheren Kontext des Beispiels finden Sie unter Auflisten von Antworten auf Kanalnachrichten.

Eigenschaften

Eigenschaft Typ Beschreibung
id Int32 Index einer Entität, die in der angegebenen chatMessage erwähnt wird. Stimmt mit dem {index}-Wert im entsprechenden <at id="{index}"> Tag im Nachrichtentext überein.
mention Text string Zeichenfolge, die zur Darstellung der Erwähnung verwendet wird. Zum Beispiel der Anzeigename eines Benutzers, ein Teamname.
erwähnt chatMessageMentionedIdentitySet Die Entität (Benutzer, Anwendung, Team, Kanal oder Chat), die wurde @mentioned.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "id": 1024,
  "mentionText": "string",
  "mentioned": {"@odata.type": "microsoft.graph.chatMessageMentionedIdentitySet"}
 }