---
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


---

# インポートセット API

# インポートセット API {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：18分

インポートセット API は、インポートセットテーブルを操作できるようにするエンドポイントを提供します。
この API は、関連する変換マップに基づいて受信データを変換します。インポートセット API は同期変換をサポートしています。インポートセット API は、既存の SOAP インターフェイスを反映します。

## セキュリティ

REST API を介したテーブルへのアクセスは、BasicAuth によって制限されます。認証または承認なしでテーブルへのアクセスを許可するには、テーブル名を sys_public.list に追加します。テーブルで定義された ACL は引き続き適用され、ACL を非アクティブ化するのはアドミンの責任です。

## インポートセット:GET /now/import/{stagingTableName}/{sys_id} {#ariaid-title2}

指定されたインポートステージングレコードと結果の変換結果を取得します。

### URL 形式 {#import-GET__section_xhz_wyy_cmb}

バージョニングされた URL: /api/now/{api_version}/import/{stagingTableName}/{sys_id}

デフォルト URL: /api/now/import/{stagingTableName}/{sys_id}  
注:  
使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#import-GET__entry__2}{#import-GET__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| ステージングテーブル名 | インポートデータを取得するテーブルの名前。 データタイプ：文字列 |
| sys_id | データを含むレコードのSys_id。 データタイプ：文字列 |
[表 : 1. パスパラメーター]

{#import-GET__entry__10}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 2. クエリパラメーター]

{#import-GET__entry__14}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 3. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#import-GET__entry__18}{#import-GET__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 4. 要求ヘッダー]

{#import-GET__entry__22}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 5. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#import-GET__entry__26}{#import-GET__entry-200-status-code}{#import-GET__entry-401-status-code}{#import-GET__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 404 | 指定されたリソースが利用できなかったことを示します。インポートセットテーブルはスケジュールに基づいて頻繁に削除されるため、変換結果が存在しなくなった場合、GET 要求は「404 見つかりません」という応答を返すことがあります。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 6. ステータスコード]

### 応答本文のパラメーター (JSON または XML)

{#import-GET__table_edp_5dz_cmb__entry__2}

| 名前 | 説明 |
|-|-|
| import_set | インポートセットの名前。 データタイプ：文字列 |
| result | インポートされたデータセットに関する情報を含むオブジェクトのリスト。 データタイプ：アレイ "result": [ { "display_name": "String", "display_value": "String", "record_link": "String", "status": "String", "sys_id": "String", "table": "String", "transform_map": "String" } ] |
| result.display_name | 表示値が true であるテーブル内の特定の列の表示名。たとえば、 数値です。 データタイプ：文字列 |
| result.display_value | display_name列の表示値。たとえば、 CHG0000123 などです。 データタイプ：文字列 |
| result.record_link | インポートされたレコードのテーブル API GET 要求。 データタイプ：文字列 |
| result.status | インポートのステータス。 データタイプ：文字列 |
| result.sys_id | インポートレコードのSys_id。 データタイプ：文字列 |
| result.table | データがインポートされたテーブルの名前。 データタイプ：文字列 |
| result.transform_map | 変換マップの名前。 データタイプ：文字列 |
| staging_table | インポートステージングテーブルの名前。 データタイプ：文字列 |
[ ]

{#import-GET__table_edp_5dz_cmb}  

### cURL 要求のサンプル

    curl "https://instance.servicenow.com/api/now/import/imp_user/e2928be64f411200adf9f8e18110c777" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    {
      "import_set": "ISET0010001",
      "staging_table": "imp_user",
      "result": [
        {
          "transform_map": "User",
          "table": "sys_user",
          "display_name": "name",
          "display_value": "John Public",
          "record_link": "https://instance.service-now.com/api/now/table/sys_user/ea928be64f411200adf9f8e18110c777",
          "status": "inserted",
          "sys_id": "ea928be64f411200adf9f8e18110c777"
        }
      ]
    }

## インポートセット:POST /now/import/{stagingTableName} {#ariaid-title3}

指定されたステージングテーブルに受信データを挿入し、インポートセットテーブルの事前定義された変換マップに基づいて変換をトリガーします。
変換は同期的に行われます。定義した各変換マップの応答には、ターゲットレコードに関する情報などの変換結果が含まれます。  
注:  
変換スクリプトのstatus_messageフィールドとerror_messageフィールドが処理され、カスタム応答フィールドとともに応答として返されます。

### URL 形式 {#import-POST__section_b32_xcz_cmb}

バージョニングされた URL: /api/now/{api_version}/import/{stagingTableName}

デフォルト URL: /api/now/import/{stagingTableName}  
注:  
使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

注:  
インポートセットの POST メソッドは、要求本文のパラメーターで文字列データ型の名前と値のペアのみを受け入れます。他のデータタイプが指定されている場合、インポートセットテーブルに格納される結果の値が意図した形式に準拠しない可能性があります。たとえば、ネストされた JSON オブジェクトの ":" の概念は "=" に変更されます。
{#import-POST__entry__2}{#import-POST__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| ステージングテーブル名 | データのインポート元のテーブルの名前。 データタイプ：文字列 |
[表 : 7. パスパラメーター]

{#import-POST__entry__8}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 8. クエリパラメーター]

{#import-POST__entry__12}

| 名前 | 説明 |
|-|-|
| コール固有 | インポートフィールドに挿入する名前と値のペア。 データタイプ：文字列 |
[表 : 9. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#import-POST__entry__16}{#import-POST__accept-RESTAPI}{#import-POST__content_type-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 10. 要求ヘッダー]

{#import-POST__entry__22}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 11. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#import-POST__entry__26}{#import-POST__entry-200-status-code}{#import-POST__entry-401-status-code}{#import-POST__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 201 | 成功。要求が正常に作成されました。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 12. ステータスコード]

### 応答本文のパラメーター (JSON または XML)

{#import-POST__table_xth_xdz_cmb__entry__2}

| 名前 | 説明 |
|-|-|
| import_set | インポートセットの名前。 データタイプ：文字列 |
| result | インポートされたデータセットに関する情報を含むオブジェクトのリスト。 データタイプ：アレイ "result": [ { "display_name": "String", "display_value": "String", "record_link": "String", "status": "String", "sys_id": "String", "table": "String", "transform_map": "String" } ] |
| result.display_name | 表示値が true であるテーブル内の特定の列の表示名。たとえば、 数値です。 データタイプ：文字列 |
| result.display_value | display_name列の表示値。たとえば、 CHG0000123 などです。 データタイプ：文字列 |
| result.record_link | インポートされたレコードのテーブル API GET 要求。 データタイプ：文字列 |
| result.status | インポートのステータス。 データタイプ：文字列 |
| result.sys_id | インポートレコードのSys_id。 データタイプ：文字列 |
| result.table | データがインポートされたテーブルの名前。 データタイプ：文字列 |
| result.transform_map | 変換マップの名前。 データタイプ：文字列 |
| staging_table | インポートステージングテーブルの名前。 データタイプ：文字列 |
[ ]

{#import-POST__table_xth_xdz_cmb}  

### cURL 要求のサンプル

    curl "https://instance.servicenow.com/api/now/import/imp_user" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{'first_name':'John','last_name':'Public','user_id':'john.public','email':'john.public@company.com'}" \
    --user "username":"password"

    {
      "import_set": "ISET0010001",
      "staging_table": "imp_user",
      "result": [
        {
          "transform_map": "User",
          "table": "sys_user",
          "display_name": "name",
          "display_value": "John Public",
          "record_link": "https://instance.servicenow.com/api/now/table/sys_user/ea928be64f411200adf9f8e18110c777",
          "status": "inserted",
          "sys_id": "ea928be64f411200adf9f8e18110c777"
        }
      ]
    }

## インポートセット:POST /now/import/{stagingTableName}/insertMultiple {#ariaid-title4}

指定されたステージングテーブルに複数のレコードを挿入し、事前定義された変換マップまたは強力な変換エンジン (RTE) 構成に基づいて単一の要求で変換をトリガーします。
デフォルトでは、変換は非同期です。同期変換を設定するには、REST での複数挿入 \[sys_rest_insert_multiple\] テーブルに新しいレコードを作成し、ソーステーブルを選択して、変換を同期に設定します。  
このエンドポイントは、2 つの形式で要求本文を送信できます。

データソースファイル形式
:   JSON データソースからステージングテーブルを生成する場合は、ソースファイルの JSON 形式と一致させます。

ステージングテーブルの列形式
:   デフォルト。キーと値のペアのステージングテーブル列要求本文形式と一致します。

### URL 形式 {#import-POST-insertMultiple__section_b32_xcz_cmb}

バージョニングされた URL: /api/now/{api_version}/import/{stagingTableName}/insertMultiple

デフォルト URL: /api/now/import/{stagingTableName}/insertMultiple  
注:  
使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

注:  
インポートセットの POST メソッドは、要求本文のパラメーターで文字列データ型の名前と値のペアのみを受け入れます。他のデータタイプが指定されている場合、インポートセットテーブルに格納される結果の値が意図した形式に準拠しない可能性があります。たとえば、ネストされた JSON オブジェクトの ":" の概念は "=" に変更されます。
{#import-POST-insertMultiple__entry__2}{#import-POST-insertMultiple__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| ステージングテーブル名 | データのインポート元のインポートセットテーブルの名前。「 [インポートセットの主要な概念](https://www.servicenow.com/docs/access?context=c_ImportSetsKeyConcepts&version=australia&pubname=australia-integrate-applications&ft:locale=en-US)」を参照してください。 データタイプ：文字列 |
[表 : 13. パスパラメーター]

{#import-POST-insertMultiple__entry__8}

| 名前 | 説明 |
|-|-|
| multi_import_set_id | マルチインポートセット \[sys_multi_import_set\] テーブルのエントリのSys_id。指定した場合、新しい複数インポートセットに追加する代わりに、現在のインポートをこの複数インポートセットに追加します。 データタイプ：文字列 テーブル： |
| run_after | 実行するエントリのSys_id。指定したインポートセットが完了した後に現在のインポートセットを実行できるようにします。このパラメーターを使用して、インポートの順序を強制することができます。 このパラメーターは、非同期変換でのみ有効です。 データタイプ：文字列 テーブル:インポートセット \[sys_import_set\] |
[表 : 14. クエリパラメーター]

{#import-POST-insertMultiple__table_uc3_ztw_rnb__entry__2}

| フォーマット | 説明 |
|-|-|
| データソースファイル | この要求本文形式は、データソースの作成に使用された JSON ファイル形式と一致します。データソースの JSON と同じ形式で要求本文を指定します。JSON 入力は、データソースのプロパティによって異なります。[ファイルタイプのデータソース](https://www.servicenow.com/docs/access?context=r_FileTypeDataSource&version=australia&pubname=australia-integrate-applications&ft:locale=en-US)の JSON 情報を参照してください。 * このオプションは、ステージングテーブルが JSON データソースを使用して作成された場合にのみ使用できます。「 [ファイルタイプのデータソースの作成](https://www.servicenow.com/docs/access?context=create-file-type-data-source&version=australia&pubname=australia-integrate-applications&ft:locale=en-US)」を参照してください。 * データソースのパスは、\[ 各行のパス \] フィールドのデータソース \[sys_data_source\] テーブルで定義する必要があります。 * REST での複数挿入ユーザーのデフォルトの動作を変更するには、REST での複数挿入 \[sys_rest_insert_multiple\] テーブルにエントリーを作成します。 * REST での複数挿入エントリで \[ データソース形式を使用 \] を有効にします。 {#import-POST-insertMultiple__ul_swc_knx_rnb} データタイプ: オブジェクト |
| ステージングテーブル列 (デフォルト) | この要求本文形式は、ステージングテーブルの列と一致します。インポートフィールドに挿入するステージングテーブル列に一致するキーと値のペアの records アレイを使用します。各 JSON キーは、テーブル列を挿入する値を表す JSON 値にマップします。JSON 入力は、ステージングテーブルのフィールドによって異なります。 列マッピングのデフォルトキー値は列テーブルです。 { "records":[ { "<ColumnLabel1>":"<value>", "<ColumnLabel2>":"<value>" }, { "<ColumnLabel1>":"<value>", "<ColumnLabel2>":"<value>" } ] } マッピング設定を変更するには、\[Rest Insert Multiples \[sys_rest_insert_multiple\] テーブルにエントリを追加し、 列マッピング を \[ラベル\] から \[列名\] に変更します。 { "records":[ { "<column_name1>":"<value>", "<column_name2>":"<value>" }, { "<column_name1>":"<value>", "<column_name2>":"<value>" } ] } [Data dictionary tables](https://www.servicenow.com/docs/access?context=c_DataDictionaryTables&version=australia&pubname=australia-platform-administration&ft:locale=en-US)は、システム内のテーブルフィールドの詳細を提供します。 データタイプ：アレイ |
[表 : 15. 要求本文 (JSON)]

{#import-POST-insertMultiple__table_uc3_ztw_rnb}

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#import-POST-insertMultiple__entry__20}{#import-POST-insertMultiple__accept-JSON-only-entry-RESTAPI}{#import-POST-insertMultiple__content_type-JSON-only-entry-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 16. 要求ヘッダー]

{#import-POST-insertMultiple__entry__26}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 17. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#import-POST-insertMultiple__entry__30}{#import-POST-insertMultiple__entry-200-status-code}{#import-POST-insertMultiple__entry-401-status-code}{#import-POST-insertMultiple__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 201 | 成功。要求が正常に作成されました。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 18. ステータスコード]

### 応答本文 (JSON)

{#import-POST-insertMultiple__table_smw_4xr_lnb__entry__2}

| 名前 | 説明 |
|-|-|
| import_set_id | 追加されたレコードのSys_id。非同期要求の場合は、このインポートセットプロセスが完了した後に、この値を使用して別のインポートセットを実行できます。 データタイプ：文字列 テーブル:インポートセット \[sys_import_set\] |
| multi_import_set_id | 追加されたレコードのSys_id。複数のインポートセットを 1 つのセットにグループ化するには、この値を使用します。 データタイプ：文字列 テーブル:マルチインポートセット \[sys_multi_import_set\] |
[ ]

{#import-POST-insertMultiple__table_smw_4xr_lnb}  

### cURL 要求のサンプル

次の例は、ステージングテーブルの列形式を使用して、u_employee_import_set_table と呼ばれるインポートテーブルで変換を実行する方法を示しています。

    curl "https://instance.servicenow.com/api/now/import/u_employee_import_set_table/insertMultiple" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"records\": [
      {
       \"Address\": \"Hollywood\",
       \"Name\": \"Tom\",
       \"ID\": \"123\"
      },
      {
       \"Address\": \"Vine\",
       \"Name\": \"Irene\",
       \"ID\": \"456\"
      }
      ]
    }" \
    --user 'username':'password'

結果には、インポートセット \[sys_import_set\] テーブルおよびマルチインポートセット \[sys_multi_import_set\] テーブルの新しいレコードのsys_idsが含まれます。

    {
      "import_set_id": "<import_set_sys_id>",
      "multi_import_set_id": "<multi_import_set_sys_id>"
    }