注意
Microsoft Graph Toolkit は非推奨です。 2025 年 9 月 1 日から、2026 年 8 月 28 日に完全な退職が予定されています。 開発者は、Web エクスペリエンスを構築するために、Microsoft Graph SDK またはその他のサポートされている Microsoft Graph ツールを使用して移行する必要があります。 詳細については、 非推奨のお知らせを参照してください。
注:
このコンポーネントはプレビュー段階であり、変更される可能性があります。 運用アプリケーションでのこれらのコンポーネントの使用はサポートされていません。 このコンポーネントは現在、React コンポーネントとしてのみ使用でき、Web コンポーネントと同等のコンポーネントはありません。 この機能は、リアルタイム エンドポイント、大容量 API を利用し、Microsoft Teams API の 支払いモデルとライセンス要件で説明されているのと同じ課金モデルの対象となります。
チャット コンポーネントを使用すると、ユーザーは 1 対 1 またはグループ会話を行うことができます。 このコンポーネントでは、チャネル会話はサポートされていません。 コンポーネントを使用すると、会話をレンダリングし、新しいメッセージを作成できます。 すべてのデータはMicrosoft Teamsに格納されます。
例
次の例では、 mgt-chat コンポーネントを使用して会話を表示します。
プロパティ
| 属性 | プロパティ | 説明 |
|---|---|---|
| chat-id | chatId | レンダリングする 1:1 またはグループ 会話 を設定する文字列 ID。 必須です。 |
CSS カスタム プロパティ
mgt-chat コンポーネントでは、CSS カスタム プロパティは定義されません。
イベント
mgt-chat コンポーネントでは、イベントは提供されません。
テンプレート
mgt-chat コンポーネントには、オーバーライドするテンプレートは用意されていません。
Microsoft Graph のアクセス許可
このコントロールは、以下の Microsoft Graph API とアクセス許可を使用します。
| 構成 | アクセス許可 | API |
|---|---|---|
chatId が設定されている |
Chat.ReadBasic、Chat.Read、ChatMessage.Read、Chat.ReadWrite、ChatMember.ReadWrite | /chats/{id}/messages, /chats/{id}/messages, /chats/{id}/messages/{messageId}, /me/chats/{id}/messages/{messageId}/softDelete, /chats/{id}/members/{membershipId}, /chats/{id}/members, /chats/{id}/messages/{messageid}/hostedContents/{hostedContentId}, /chats/{id} |
サブコンポーネント
mgt-chat コンポーネントは、前に示したアクセス許可以外のアクセス許可を必要とする可能性がある 1 つ以上のサブコンポーネントで構成されます。 詳細については、各サブコンポーネントのドキュメントを参照してください。
認証
mgt-chat コンポーネントは、認証ドキュメントで説明されているグローバル認証プロバイダーを使用します。
キャッシュ
mgt-chat コンポーネントは、チャット メッセージと関連するメタデータをキャッシュします。
ローカリゼーション
mgt-chat コンポーネントでは、ローカライズ変数は公開されません。
既知の問題
-
mgt-chatコンポーネントは、コンポーネントの複数のインスタンスまたは複数のタブで使用されている同じchatIdをサポートしていません。 -
mgt-chatコンポーネントはテーマをサポートしていないため、ブラウザーの設定を尊重しません。