targetedChatMessage リソースの種類

名前空間: microsoft.graph

重要

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

指定された受信者にのみ表示される Microsoft Teams のターゲット メッセージを表します。 グループ チャットまたはチャネルのすべての参加者に表示される通常のメッセージとは異なり、ターゲットを絞ったメッセージは、ユーザー固有の情報を必要とするボットとの対話とアプリからユーザーへの通信のプライバシーを提供します。

ターゲット メッセージは、次のようなシナリオで使用されます。

  • グループ コンテキストでのボット認証要求。資格情報は要求側のユーザーにのみ表示される必要があります。
  • 参加しているメンバーにのみ表示される、新しいメンバーの Chat の概要。
  • 機密情報やユーザー固有の情報を含むプロアクティブおよびリアクティブ ボット メッセージ。

chatMessage から継承します。

メソッド

メソッド 戻り値の種類 説明
すべてのターゲット メッセージを取得する targetedChatMessage コレクション グループ チャットおよびチャネルで特定のユーザーに送信された すべてのターゲット メッセージを 取得します。
保持されているすべてのターゲット メッセージを取得する targetedChatMessage コレクション グループ チャットおよびチャネルで特定のユーザーに送信された、すべての 保持ターゲット メッセージを 取得します。
チャネルからターゲット メッセージを削除する なし チャネル コンテキストから特定の ターゲット メッセージ を削除します。
チャットからターゲット メッセージを削除する なし チャット コンテキストから特定の ターゲット メッセージ を削除します。

プロパティ

プロパティ 説明
attachments chatMessageAttachment コレクション 添付されたオブジェクト (ファイル、タブ、会議、その他のアイテムなど) への参照。 chatMessage から継承されます。
body itemBody メッセージの内容。 chatMessage から継承されます。
channelIdentity channelIdentity 対象のメッセージがチャネル コンテキストで送信された場合のチャネルとチームの情報。 channelId プロパティと teamId プロパティが含まれます。 chatMessage から継承されます。
chatId 文字列 対象のメッセージがグループ チャット コンテキストで送信された場合の、チャットの一意識別子。 chatMessage から継承されます。
createdDateTime DateTimeOffset メッセージが作成された日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 chatMessage から継承されます。
deletedDateTime DateTimeOffset メッセージが削除された日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 保持メッセージにのみ適用されます。 chatMessage から継承されます。
etag 文字列 メッセージのバージョン番号。 chatMessage から継承されます。
eventDetail eventMessageDetail このメッセージがシステム イベントを表す場合は、イベントに関する詳細。 chatMessage から継承されます。
from chatMessageFromIdentitySet 対象メッセージの送信者に関する詳細。 chatMessage から継承されます。
id 文字列 メッセージの一意識別子。 メッセージ ID は、特定のユーザーの単一の会話 (チャットまたはチャネル) のコンテキスト内でのみ一意です。 chatMessage から継承されます。
importance chatMessageImportance メッセージの重要度です。 使用可能な値: normalhighurgentunknownFutureValuechatMessage から継承されます。
lastEditedDateTime DateTimeOffset メッセージが最後に編集された日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 chatMessage から継承されます。
lastModifiedDateTime DateTimeOffset メッセージまたはそのプロパティが最後に変更された日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 chatMessage から継承されます。
ロケール 文字列 クライアントによって設定されたメッセージのロケール ( en-us 形式)。 chatMessage から継承されます。
mentions chatMessageMention コレクション メッセージに記載されているエンティティの一覧。 chatMessage から継承されます。
messageHistory chatMessageHistoryItem コレクション メッセージに適用された編集の履歴。 chatMessage から継承されます。
messageType chatMessageType メッセージの種類。 使用可能な値: messagechatEventtypingunknownFutureValuesystemEventMessagePrefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得します。systemEventMessagechatMessage から継承されます。
onBehalfOf chatMessageFromIdentitySet その人の代わりにメッセージを送信したユーザーに関する情報。 chatMessage から継承されます。
policyViolation chatMessagePolicyViolation データ損失防止 (DLP) アプリケーションによってメッセージに適用されたポリシー違反に関する情報。 chatMessage から継承されます。
reactions chatMessageReaction コレクション メッセージに適用されたリアクション (例: いいね、ハート、笑い)。 chatMessage から継承されます。
受信者 identity ターゲット メッセージの意図された受信者。
replyToId 文字列 スレッドの親メッセージまたはルート メッセージの ID。 chatMessage から継承されます。
subject String メッセージの件名。 chatMessage から継承されます。
概要 文字列 通知または概要ビューに使用できるメッセージの概要テキスト。 chatMessage から継承されます。
webUrl String Microsoft Teams のメッセージへのリンク。 chatMessage から継承されます。

リレーションシップ

リレーションシップ 説明
hostedContents chatMessageHostedContent コレクション 画像やコード スニペットなど、メッセージでホストされているコンテンツ。 chatMessage から継承されます。
返信 chatMessage コレクション メッセージへの返信。 現在、ターゲット メッセージではサポートされていません。 chatMessage から継承されます。

JSON 表記

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

{
  "@odata.type": "#microsoft.graph.targetedChatMessage",
  "attachments": [{"@odata.type": "microsoft.graph.chatMessageAttachment"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "channelIdentity": {"@odata.type": "microsoft.graph.channelIdentity"},
  "chatId": "String",
  "createdDateTime": "String (timestamp)",
  "deletedDateTime": "String (timestamp)",
  "etag": "String",
  "eventDetail": {"@odata.type": "microsoft.graph.eventMessageDetail"},
  "from": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
  "id": "String (identifier)",
  "importance": "String",
  "lastEditedDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "locale": "String",
  "mentions": [{"@odata.type": "microsoft.graph.chatMessageMention"}],
  "messageHistory": [{"@odata.type": "microsoft.graph.chatMessageHistoryItem"}],
  "messageType": "String",
  "onBehalfOf": {"@odata.type": "microsoft.graph.chatMessageFromIdentitySet"},
  "policyViolation": {"@odata.type": "microsoft.graph.chatMessagePolicyViolation"},
  "reactions": [{"@odata.type": "microsoft.graph.chatMessageReaction"}],
  "recipient": {"@odata.type": "microsoft.graph.identity"},
  "replyToId": "String",
  "subject": "String",
  "summary": "String",
  "webUrl": "String"
}