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