chatMessageMention リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

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

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

たとえば、チャット メッセージには 2 つのメンションが含まれており、それぞれ メンション テキスト "Megan" と "Alex" が含まれています。 その body content プロパティは、2 つのメンションの 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>"
}

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

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

この例の完全なコンテキストについては、「 チャネル メッセージの応答を一覧表示する」を参照してください。

プロパティ

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

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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