chatMessageMention リソースの種類chatMessageMention resource type

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

Chatmessageエンティティ内のメンションを表します。Represents a mention in a chatMessage entity. メンションは、ユーザーチーム、ボット、またはチャネルにすることができます。The mention can be to a user, team, bot, or channel.

1つまたは複数のメンションを含むChatmessageオブジェクトでは、メッセージ本文のコンテンツプロパティは、HTML でチャットメッセージを表します。In a chatMessage object that contains one or more mentions, the message body content property represents the chat message in HTML. 各メンションのmentionTextを HTML at要素で囲みます。属性はid 、メンションのidプロパティに対応しています。It encloses the mentionText of each mention in an HTML at element, with an id attribute that corresponds to the id property of the mention.

一例として、チャットメッセージには2つのメンションが含まれており、それぞれに "Megan" と "Alex" という説明文があります。As an example, a chat message contains two mentions, with the mention text "Megan" and "Alex" respectively. Bodyコンテンツプロパティは、 at 2 つのメンションの要素を次のように指定します。Its body content property specifies at elements for the two mentions as follows:

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

コンテンツプロパティの最初のメンションには、0 idの HTML 属性があります。In the content property, the first mention has an HTML id attribute of 0. これは、 chatMessageMentionの最初のインスタンスのidプロパティに対応します。これは0でもあります。This corresponds to the id property of that first instance of chatMessageMention, which is also 0.

2番目のメンidションの属性は1で、2番目のインスタンスのidプロパティと一致します。1は1です。The second mention has an id attribute of 1, matching the id property of the second instance, which is 1.

この例の詳細については、「 List channel message リプライ」を参照してください。For a fuller context of the example, see List channel message replies.

プロパティProperties

プロパティProperty Type 説明Description
idid Int32Int32 指定したChatmessageで言及されているエンティティのインデックスです。Index of an entity being mentioned in the specified chatMessage. メッセージ本文の対応する<at id="{index}">タグの {index} 値と一致します。Matches the {index} value in the corresponding <at id="{index}"> tag in the message body.
mentionTextmentionText stringstring メンションを表すために使用される文字列。String used to represent the mention. たとえば、ユーザーの表示名、チーム名。For example, a user's display name, a team name.
明記mentioned identitySetidentitySet 前述したエンティティ (ユーザー、アプリケーション、チーム、またはチャネル)。The entity (user, application, team, or channel) that was mentioned. @Mentioned されたチャネルまたはチームの場合は、チーム/チャネルの ID を提供する会話プロパティと、チームまたはチャネルのいずれかを表すconversationIdentityTypeプロパティが含まれます。If it was a channel or team that was @mentioned, the identitySet contains a conversation property giving the ID of the team/channel, and a conversationIdentityType property that represents either the team or channel.

JSON 表記JSON representation

リソースの JSON 表記を次に示します。The following is a JSON representation of the resource.

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