chatMessageMention リソースの種類

名前空間: microsoft.graph

chatMessage エンティティのメン ションを表 します。 メンションは、ユーザー、チーム、ボット、またはチャネルに対して実行できます。

1 つ以上のメンションを含む chatMessage オブジェクトでは、メッセージ本文 コンテンツ プロパティは HTML のチャット メッセージを表します。 各メンション の mentionText を HTML 要素で囲み、メンションの id プロパティに対応 at する属性 id を指定します。

たとえば、チャット メッセージには 2 つのメンションが含まれるので、それぞれメンション テキスト "Megan" と "Alex" が含まれる。 本文コンテンツ プロパティ は、次 at のように 2 つのメンションの要素を指定します。

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

content プロパティ では 、最初のメンションの HTML 属性は id 0 です。 これは 、chatMessageMention の最初のインスタンスの id プロパティ (0) にも対応します。

2 番目のメンションの id 属性は 1 で、2 番目のインスタンス の id プロパティ (1) と一致します。

この例の詳細なコンテキストについては、「リスト チャネル メッセージの返信 」を参照してください。

プロパティ

プロパティ	型	説明
id	Int32	指定した chatMessage に記載されているエンティティ のインデックス です。 メッセージ本文の対応するタグの {index} 値 <at id="{index}"> と一致します。
mentionText	string	メンションを表す文字列。 たとえば、ユーザーの表示名、チーム名などです。
に記載されている	chatMessageMessageIdentitySet	作成されたエンティティ (ユーザー、アプリケーション、チーム、またはチャネル) @mentioned。

JSON 表記

リソースの JSON 表記を次に示します。

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