--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # AI 検索 外部ユーザーマッピング API # AI 検索 外部ユーザーマッピング API {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：9分 AI 検索外部ユーザーマッピング API は、外部ソースから ServiceNow® AI 検索 アプリケーションのインデックスにユーザーマッピング情報を取り込むことができるエンドポイントを提供します。 ## AI 検索 外部ユーザーマッピング - POST /ais/external_content/user_mapping/import_multiple/{target_table} {#ariaid-title2} 外部ユーザーマッピングのリストを AI 検索 ユーザーマッピングテーブルにインポートします。各マッピングでは、 ServiceNow AI Platform ユーザーの外部定義ユーザーおよびグループエイリアスを指定します。 AI 検索 はこれらのエイリアスを使用して、ユーザーが表示できる外部ドキュメント検索結果を決定します。 外部コンテンツセキュリティ AI 検索 外部ユーザーマッピングを利用する方法については、「 [AI 検索の外部コンテンツセキュリティ](https://www.servicenow.com/docs/access?context=external-content-security-ais&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」を参照してください。 外部ユーザーマッピングのユーザー名とグループ名は、 外部コンテンツ取り込み API の POST /ais/external_content/ingestDocument/{schema_table_name} エンドポイントを介して取り込まれた外部ドキュメントのセキュリティアクセス権限で指定されているものと一致する必要があります。外部で定義されたユーザーおよびグループのセキュリティアクセス権限を持つ外部ドキュメントの取り込みの詳細については、「 [外部コンテンツ取り込み API](https://servicenow-prod.fluidtopics.net/4taFoo1oh4fAiXCLDpTP0Q#external-content-ingestion-api "外部コンテンツ取り込み API は、ServiceNow インスタンスの外部のソースから ServiceNow AI 検索 アプリケーションのインデックスにコンテンツを取り込むことができるエンドポイントを提供します。")」を参照してください。 このエンドポイントを介してインポートされた外部ユーザーマッピングレコードのインポート履歴を表示するには、 AI 検索外部コンテンツユーザーマッピングインポート履歴. 履歴レコードから、インポートタスクのインポートセット \[sys_import_set\] レコードとマルチインポートセット \[sys_multi_import_set\] レコードを表示できます。これらのレコードの情報を使用して、外部ユーザーマッピングが正しくインポートされたことを確認します。 ### URL 形式 バージョニングされた URL: /api/now/{api_version}/ais/external_content/user_mapping/import_multiple/{target_table} 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#ext_user_map-POST-import_multiple__entry__2}{#ext_user_map-POST-import_multiple__version-not_optional-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | target_table | インポートされたマッピングを表示する AI 検索 ユーザーマッピングテーブルの名前。たとえば、 x_snc_sharepoint_user_table などです。 注: 次を使用してターゲット AI 検索 ユーザーマッピングテーブルを作成する必要があります AI 検索外部コンテンツユーザーマッピングの作成 このエンドポイントを使用する前のモジュール。存在しないユーザーマッピングテーブルを指定すると、要求は失敗します。 データタイプ：文字列 | [表 : 1. パスパラメーター] {#ext_user_map-POST-import_multiple__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 2. クエリパラメーター] {#ext_user_map-POST-import_multiple__entry__12} | 名前 | 説明 | |-|-| | {オブジェクト} | 必須です。名前のないオブジェクト。 データタイプ: オブジェクト { "records": [Array] } | | {object}.records | 必須です。オブジェクトのアレイ。各オブジェクトは、指定されたターゲットテーブルにインポートするユーザーマッピングを表します。 データタイプ：アレイ "records": [ { "external_group": [Array], "external_user": [Array], "mapping_value": "String" } ] | | {object}.records.external_group | 文字列のアレイ。各文字列は、{object}.records.mapping_value パラメーターで指定されたServiceNow AI Platformユーザーのエイリアスとして設定する、外部定義グループの名前です。 データタイプ：アレイ 値は、ユーザーマッピング用に選択された外部定義グループの名前に応じて、任意の形式にすることができます。例： "external_group": [ "itil", "hr-admin", "report-dev" ] | | {object}.records.external_user | 文字列のアレイ。各文字列は、{object}.records.mapping_value パラメーターで指定されたServiceNow AI Platformユーザーのエイリアスとして設定する外部定義ユーザーの名前です。 データタイプ：アレイ 値は、ユーザーマッピング用に選択された外部定義ユーザーアカウントの名前に応じて、任意の形式にすることができます。例： "external_user": [ "beth-anglin", "ad\beth.anglin", "beth-anglin@sharepoint" ] | | {object}.records.mapping_value | 既存のレコードを一意に識別するメールフィールド値。要求内のすべての外部定義ユーザーおよびグループエイリアスは、このメールアドレスを持つ ServiceNow AI Platform ユーザーにマップされます。 注: API は、このパラメーターをユーザーマッピングレコードの一意の識別子として扱います。既存のユーザーマッピングレコードと同じ mapping_value 別のユーザーマッピングをインポートすると、新しいレコードによって既存のレコードが上書きされます。 データタイプ：文字列 テーブル： ユーザー \[sys_user\] | [表 : 3. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#ext_user_map-POST-import_multiple__entry__24}{#ext_user_map-POST-import_multiple__accept-JSON-only-entry-RESTAPI}{#ext_user_map-POST-import_multiple__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 4. 要求ヘッダー] {#ext_user_map-POST-import_multiple__entry__30} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#ext_user_map-POST-import_multiple__entry__34}{#ext_user_map-POST-import_multiple__entry-400-status-code}{#ext_user_map-POST-import_multiple__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 201 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 6. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#ext_user_map-POST-import_multiple__entry__42} | 名前 | 説明 | |-|-| | エラー | 要求の処理中に発生したエラーを説明するオブジェクト。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | 要求の処理中に発生したエラーの詳細。 データタイプ：文字列 | | error.message | 要求の処理中に発生したエラーのメッセージ。 データタイプ：文字列 | | import_set_id | 要求の成功によってインポートセット \[sys_import_set\] テーブルに作成された新しいレコードのSys_id。 データタイプ：文字列 | | multi_import_set_id | 要求の成功によってマルチインポートセット \[sys_multi_import_set\] テーブルに作成された新しいレコードのSys_id。 データタイプ：文字列 | | result | 失敗した要求の結果。要求が失敗した理由を説明するメッセージが含まれます。 データタイプ：文字列 | | status | 失敗した要求のステータス。 有効な値： * failure {#ext_user_map-POST-import_multiple__ul_h5r_z54_pnb} データタイプ：文字列 | [ ] ### cURL 要求 ServiceNow AI Platformユーザー Beth Anglin と Abel Tuter の外部定義ユーザーおよびグループのエイリアスを、x_snc_sharepoint_user_table という名前のAI 検索ユーザーマッピングテーブルにインポートします。 curl -X POST 'https://instance.servicenow.com/api/now/v1/ais/external_content/user_mapping/import_multiple/x_snc_sharepoint_user_table' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -u 'username':'password' \ -d '{ "records": [ { "mapping_value": "beth.anglin@example.com", "external_user": [ "ad\beth-anglin", "beth.anglin@sharepoint" ], "external_group": [ "itil", "itil-admin", "itil-dev" ] }, { "mapping_value": "abel.tuter@example.com", "external_user": [ "ad\abel-tuter", "abel.tuter@sharepoint" ], "external_group": [ "hr", "hr-admin", "hr-dev" ] } ] }' 応答には、生成されたインポートセットレコードとマルチインポートセットレコードのsys_idsが表示されます。 { "import_set_id": "6e9ddb629d987010f877878bd9f0e9dd", "multi_import_set_id": "269ddb629d987010f877878bd9f0e9de" } ### cURL 要求 {#ext_user_map-POST-import_multiple__example_qz3_1pz_spb} 空のマッピングレコードを含む無効な要求をインポートします。 curl 'https://instance.servicenow.com/api/now/v1/ais/external_content/user_mapping/import_multiple/u_ext_content_user_mapping' \ --request POST \ --user 'username':'password' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "records": [ { "mapping_value": "beth.anglin@example.com", "external_user": [ "ad\beth-anglin", "beth.anglin@sharepoint" ], "external_group": [ "reports", "reports-admin", "reports-dev" ] }, {} ] }' 要求はステータス 400 で失敗し、応答は失敗の性質を示します。 { "result": "Error in processing the message" }