名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
チャットから移行モードを削除して、外部メッセージの移行を完了します。 完全な移行操作は、最初の移行プロセス用に特別に設計された移行テンプレートを使用して、最初に新しく作成された標準チャネルに制限されていました。 詳細については、「 Microsoft Graph を使用してサード パーティのプラットフォーム メッセージを Teams にインポートする」を参照してください。
既存または新しいチャットに対して 完全なMigration 要求が行われた後、チャットを呼び出して移行セッションを開始できます : startMigration。
この API では、次のチャネルの種類がサポートされています。
| Entities | Sub 型 | 移行モードのサポート | 備考 |
|---|---|---|---|
| チャット | グループ、1:1 | 新規および既存 | 会議チャットはサポートされていません。 外部メンバーがサポートされています。 |
注:
- チャットの種類は、最初のインポートでは許可されません。
- フェデレーション チャットはサポートされていますが、ユーザーはフェデレーション リソースを作成できません。 たとえば、フェデレーション ユーザーの代わりにメッセージをインポートすることはできません。ターゲット チャットはイニシエーター アプリのテナントに属している必要があります。 ユーザーは、認証先のテナントにのみコンテンツをインポートできます。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | サポートされていません。 | サポートされていません。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | Teamwork.Migrate.All | 注意事項なし。 |
HTTP 要求
POST /chats/{chat-id}/completeMigration
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 204 No Content 応答コードを返します。 応答本文では何も返されません。
例
例 1: チャット内の外部メッセージの移行を完了する
次の例は、チャット内の外部メッセージの移行を完了する方法を示しています。
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/beta/chats/19:4b6bed8d24574f6a9e436813cb2617d8@thread.tacv2/completeMigration
応答
次の例は応答を示しています。
HTTP/1.1 204 No Content
例 2: チャットが既に移行モードになっているときに移行を完了する
次の例は、チャットが既に移行モードのときに移行を完了する方法を示しています。 この要求は、 400 Bad Request 応答で失敗します。
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/beta/chats/19:4b6bed8d24574f6a9e436813cb2617d8@thread.tacv2/completeMigration
応答
次の例は応答を示しています。
HTTP/1.1 400 Bad Request