Microsoft 365 Copilot コネクタ (旧称 Microsoft Graph コネクタ) SDK コントラクト接続管理 API とモデルは、Microsoft 365 管理センターでのカスタム コネクタ接続の作成プロセス中に呼び出されます。
接続管理 API
| メソッド | パラメーター | 戻り値の型 | 説明 |
|---|---|---|---|
| ValidateAuthentication | ValidateAuthenticationRequest | ValidateAuthenticationResponse | 接続設定の手順で管理者によって提供される資格情報とデータ ソース パスを検証します。 |
| ValidateCustomConfiguration | ValidateCustomConfigurationRequest | ValidateCustomConfigurationResponse | 接続構成手順で管理者によって提供されるオプションの構成を検証します。 コネクタに構成が必要ない場合、この API は成功応答を返すことができます。 |
| GetDataSourceSchema | GetDataSourceSchemaRequest | GetDataSourceSchemaResponse | Microsoft Graph で理解できる形式のデータ ソース スキーマを取得します。 |
接続管理 API モデル
次のセクションでは、接続管理 API モデルについて説明します。
ValidateAuthenticationRequest
データ ソースへの認証要求を検証するための要求モデル。
| プロパティ | 型 | 説明 |
|---|---|---|
| authenticationData | AuthenticationData | データ ソースのアクセス URL と、データ ソースにアクセスするための資格情報を保持します。 |
ValidateAuthenticationResponse
データ ソースへの認証応答を検証するための応答モデル。
| プロパティ | 型 | 説明 |
|---|---|---|
| status | OperationStatus | 操作の状態とエラー メッセージなどの詳細を表示します。 |
| oAuth2ClientCredentialResponse | OAuth2ClientCredentialResponse | OAuth フローが使用されている場合にクロール中にコネクタに送信される資格情報 (認証サーバーから送信されるアクセス トークン、更新トークンなど)。 |
ValidateCustomConfigurationRequest
カスタム構成要求情報を検証するための要求モデル。
| プロパティ | 型 | 説明 |
|---|---|---|
| customConfiguration | CustomConfiguration | コネクタの構成データを提供します。 |
| authenticationData | AuthenticationData | データ ソースのアクセス URL と、データ ソースにアクセスするための資格情報を保持します。 |
ValidateCustomConfigurationResponse
カスタム構成応答情報を検証するモデルを要求します。
| プロパティ | 型 | 説明 |
|---|---|---|
| status | OperationStatus | 操作の状態とエラー メッセージなどの詳細を表示します。 |
GetDataSourceSchemaRequest
データ ソースのスキーマ要求を取得するための要求モデル。
| プロパティ | 型 | 説明 |
|---|---|---|
| customConfiguration | CustomConfiguration | コネクタの構成データを提供します。 |
| authenticationData | AuthenticationData | データ ソースのアクセス URL と、データ ソースにアクセスするための資格情報を保持します。 |
GetDataSourceSchemaResponse
データ ソースのスキーマ応答を取得するモデルを要求します。
| プロパティ | 型 | 説明 |
|---|---|---|
| status | OperationStatus | 操作の状態とエラー メッセージなどの詳細を表示します。 |
| dataSourceSchema | DataSourceSchema | データ ソース スキーマを表示します。 |