---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Product Catalog オープン API

# Product Catalog オープン API {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：176分

Product Catalog Open API は、製品カタログ、製品オファリング、および製品仕様を作成および取得するためのエンドポイントを提供します。
この API を使用して、外部システムと Now Platform の間で製品カタログ情報を管理します。Product Catalog オープン API は、TM Forum Product Catalog Management API REST 仕様の ServiceNow® 実装です。この実装は、[TMF620 Product Catalog Management API REST Specification Version 4](https://www.tmforum.org/resources/standard/tmf620-product-catalog-management-api-user-guide-v4-1-0/) (2021 年 8 月) に基づいています。

この API は、ServiceNow Store で入手可能な Product Catalog Advanced アプリケーションに含まれています。

この API は、 `sn_tmf_api` 名前空間内で提供されます。

呼び出し元ユーザーには、sn_prd_pm_adv.catalog_integrator ロールが必要です。  
この API は、次のテーブルのデータを作成および更新します。

* 特性 \[sn_prd_pm_characteristic\]
* 特性オプション \[sn_prd_pm_characteristic_option\]
* 製品オファリング \[sn_prd_pm_product_offering\]
* 製品オファリングカタログ \[sn_prd_pm_product_offering_catalog\]
* 製品オファリング特性 \[sn_prd_pm_product_offering_characteristic\]
* 製品仕様 \[sn_prd_pm_product_specification\]
* 仕様関係 \[sn_prd_pm_specification_relationship\]
{#product-catalog-open-api__ul_fhn_pjj_hsb}

## 製品カタログオープン API - /sn_tmf_api/catalogmanagement/productOffering/{id} を削除 {#ariaid-title2}

指定された製品オファリングを削除します。

### URL 形式

デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOffering/{id}

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

{#tmf_prod_cat-DELETE-prodOffer-id__entry__2}

| 名前 | 説明 |
|-|-|
| id | 削除する製品オファリングのSys_id。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 |
[表 : 1. パスパラメーター]

{#tmf_prod_cat-DELETE-prodOffer-id__entry__6}

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

{#tmf_prod_cat-DELETE-prodOffer-id__entry__10}

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

### ヘッダー

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

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

{#tmf_prod_cat-DELETE-prodOffer-id__entry__18}

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

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
[表 : 6. ステータスコード]

{#tmf_prod_cat-DELETE-prodOffer-id__table_tmr_dgq_mbc}

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

{#tmf_prod_cat-DELETE-prodOffer-id__entry__28}

| 名前 | 説明 |
|-|-|
| メッセージ | 製品仕様の削除またはアーカイブに関する失敗または成功のメッセージ。 |
[ ]

### cURL 要求

次の例では、ID が d6f8d9995b020210235d85cced81c7eb の製品オファリングを削除します。

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOffering/d6f8d9995b020210235d85cced81c7eb" \ 
    --request DELETE\ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

応答本文は、削除成功メッセージを返します。

    "The product offering (d6f8d9995b020210235d85cced81c7eb) is successfully deleted"

## 製品カタログオープン API - /sn_tmf_api/catalogmanagement/productSpecification/{id} を削除 {#ariaid-title3}

指定された製品仕様を削除またはアーカイブします。
この DELETE メソッドを呼び出すと、製品仕様は、その状態に応じて削除またはアーカイブされます。  
* ドラフト状況の製品仕様が正常に削除されました。応答は成功メッセージを返します。
* アーカイブ済みステータスの製品仕様は削除できません。応答は、仕様がすでにアーカイブされているというメッセージを返します。
* ドラフトステータスではなく、他の製品仕様またはオファリングに関連付けられている製品仕様はアーカイブされますが、削除はされません。応答は、スペシフィケーションがアクティブステータスからアーカイブステータスに移行したことを示すメッセージを返します。
* アクティブな製品仕様またはオファリングに関連付けられている製品仕様は削除できません。応答はエラーメッセージを返します。
{#tmf_prod_cat-DELETE-prodSpec-id__ul_rmw_mw4_4bc}

### URL 形式

デフォルト URL: /sn_tmf_api/catalogmanagement/productSpecification/{id}

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

{#tmf_prod_cat-DELETE-prodSpec-id__entry__2}

| 名前 | 説明 |
|-|-|
| id | 削除する製品仕様のSys_id。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
[表 : 7. パスパラメーター]

{#tmf_prod_cat-DELETE-prodSpec-id__entry__6}

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

{#tmf_prod_cat-DELETE-prodSpec-id__entry__10}

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

### ヘッダー

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

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

{#tmf_prod_cat-DELETE-prodSpec-id__table_u3k_cgq_mbc} {#tmf_prod_cat-DELETE-prodSpec-id__entry__18}

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

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
[表 : 12. ステータスコード]

{#tmf_prod_cat-DELETE-prodSpec-id__table_tmr_dgq_mbc}

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

{#tmf_prod_cat-DELETE-prodSpec-id__entry__28}

| 名前 | 説明 |
|-|-|
| メッセージ | 製品仕様の削除またはアーカイブに関する失敗または成功のメッセージ。 |
[ ]

### cURL 要求

次の例では、ID が 8ef57fa05b308210235d85cced81c7d8 の製品仕様を削除します。

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productSpecification/8ef57fa05b308210235d85cced81c7d8" \ 
    --request DELETE\ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

応答本文は、成功または失敗のメッセージを返します。

    "The product specification (8ef57fa05b308210235d85cced81c7d8) is successfully deleted"

## 製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/catalog {#ariaid-title4}

すべての製品オファリングカタログのリストを取得します。

### URL 形式

デフォルト URL: /api/sn_tmf_api/catalogmanagement/catalog

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

{#tmf_prod_cat-GET-catalog__table_ofr_vgy_fsb__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 13. パスパラメーター]

{#tmf_prod_cat-GET-catalog__table_ofr_vgy_fsb} {#tmf_prod_cat-GET-catalog__table_c3q_ylz_gsb__entry__2}

| 名前 | 説明 |
|-|-|
| fields | 応答で返すフィールドのリスト。無効なフィールドは無視されます。このパラメーターを使用しない場合、すべてのフィールドが返されます。 データタイプ：文字列 |
| limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、offset パラメーターを使用してレコード取得をページネーションします。 デフォルト：20 最大：100 データタイプ：数値 |
| offset | レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 デフォルト：0 データタイプ：数値 |
[表 : 14. クエリパラメータ]

{#tmf_prod_cat-GET-catalog__table_c3q_ylz_gsb} {#tmf_prod_cat-GET-catalog__table_gld_vkz_gsb__entry__2}

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

{#tmf_prod_cat-GET-catalog__table_gld_vkz_gsb}

### ヘッダー

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

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 16. 要求ヘッダー]

{#tmf_prod_cat-GET-catalog__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-catalog__table_nww_xgm_lsb__entry__2}{#tmf_prod_cat-GET-catalog__content-range-row}{#tmf_prod_cat-GET-catalog__content-type-row}{#tmf_prod_cat-GET-catalog__links-pagination-row}{#tmf_prod_cat-GET-catalog__x-total-count-descr}

| ヘッダー | 説明 |
|-|-|
| Content-Range | ページネーションされた呼び出しで返されるコンテンツの範囲を指定します。 たとえば、`offset=2` および `limit=3` の場合、Content-Range ヘッダーの値は `items 3-5` です。 |
| Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Link | クエリー結果内を移動するための次のリンクが含まれています。 * first * last * next * previous {#tmf_prod_cat-GET-catalog__ul_zzk_sdm_lsb} |
| X-Total-Count | ページネーションされたクエリの場合、このヘッダーはサーバーで利用可能なレコードの合計数を指定します。 |
[表 : 17. 応答ヘッダー]

{#tmf_prod_cat-GET-catalog__table_nww_xgm_lsb}

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 要求が正常に処理されました。応答で完全なリソースが返されました (ページネーションなし)。 |
| 206 | 応答で部分的なリソースが返されました (ページネーションあり)。 |
| 400 | 要求が正しくありません。考えられる理由： * 無効なパスパラメーター * 無効な URI {#tmf_prod_cat-GET-catalog__ul_rys_1gy_fsb} |
| 404 | レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。 |
[表 : 18. ステータスコード]

{#tmf_prod_cat-GET-catalog__table_v1h_tcm_lsb}

### 応答本文のパラメーター (JSON) {#tmf_prod_cat-GET-catalog__section_g2r_kmz_gsb}

{#tmf_prod_cat-GET-catalog__table_m2z_clz_gsb__entry__2}

| 名前 | 説明 |
|-|-|
| description | 製品オファリングカタログの説明。 データタイプ：文字列 |
| id | 製品オファリングカタログ \[sn_prd_pm_product_offering_catalog\] テーブルの製品オファリングカタログの sys_id。 データタイプ：文字列 |
| name | 製品オファリングカタログの名前。 データタイプ：文字列 |
[ ]

{#tmf_prod_cat-GET-catalog__table_m2z_clz_gsb}  

### cURL 要求

この例では、すべての製品オファリングカタログを取得します。

    curl --location --request GET "https://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/catalog" \
    --user 'username':'password'

応答本文。

    [
        {
            "id": "SD-WAN1344314wrfw14345",
            "name": "New Catalog",
            "description": "New Catalog"
        },
        {
            "id": "9919291ac34c20105252716b7d40dd0f",
            "name": "Enterprise Mobile Plan",
            "description": " Product Catalog for Enterprise Mobile Plan"
        }
    ]

## 製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/catalog/{id} {#ariaid-title5}

製品オファリングカタログを取得します。

### URL 形式

デフォルト URL: /api/sn_tmf_api/catalogmanagement/catalog/{id}

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

{#tmf_prod_cat-GET-catalog-id__table_apt_nkz_gsb__entry__2}

| 名前 | 説明 |
|-|-|
| id | 取得する製品オファリングカタログの sys_id。製品オファリングカタログ \[sn_prd_pm_product_offering_catalog\] テーブルにあります。 データタイプ：文字列 |
[表 : 19. パスパラメーター]

{#tmf_prod_cat-GET-catalog-id__table_apt_nkz_gsb} {#tmf_prod_cat-GET-catalog-id__table_l5k_tkz_gsb__entry__2}

| 名前 | 説明 |
|-|-|
| fields | 応答で返すフィールドのリスト。無効なフィールドは無視されます。このパラメーターを使用しない場合、すべてのフィールドが返されます。 データタイプ：文字列 |
[表 : 20. クエリパラメーター]

{#tmf_prod_cat-GET-catalog-id__table_l5k_tkz_gsb} {#tmf_prod_cat-GET-catalog-id__table_gld_vkz_gsb__entry__2}

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

{#tmf_prod_cat-GET-catalog-id__table_gld_vkz_gsb}

### ヘッダー

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

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 22. 要求ヘッダー]

{#tmf_prod_cat-GET-catalog-id__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-catalog-id__table_tzy_thy_ksb__entry__2}{#tmf_prod_cat-GET-catalog-id__content_type-JSON-only-entry-RESTAPI}

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

{#tmf_prod_cat-GET-catalog-id__table_tzy_thy_ksb}

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。以下のいずれかの理由が考えられます。 * 無効なパスパラメーター * 無効な URI {#tmf_prod_cat-GET-catalog-id__ul_rys_1gy_fsb} |
| 404 | 見つかりません。要求アイテムが見つかりませんでした。 |
[表 : 24. ステータスコード]

{#tmf_prod_cat-GET-catalog-id__table_nxj_ykz_gsb}

### 応答本文のパラメーター (JSON)

{#tmf_prod_cat-GET-catalog-id__table_m2z_clz_gsb__entry__2}

| 名前 | 説明 |
|-|-|
| description | 製品オファリングカタログの説明。 データタイプ：文字列 |
| id | 製品オファリングカタログ \[sn_prd_pm_product_offering_catalog\] テーブルの製品オファリングカタログの sys_id。 データタイプ：文字列 |
| name | 製品オファリングカタログの名前。 データタイプ：文字列 |
[ ]

{#tmf_prod_cat-GET-catalog-id__table_m2z_clz_gsb}  

### cURL 要求

この例では、Enterprise Mobile Plan の製品オファリングカタログを取得します。

    curl --location --request GET "https://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/catalog/9919291ac34c20105252716b7d40dd0f" \
    --user 'username':'password'

応答本文。

    {
       "id": "9919291ac34c20105252716b7d40dd0f",
       "name": "Enterprise Mobile Plan",
       "description": " Product Catalog for Enterprise Mobile Plan"
    }

## 製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productOffering {#ariaid-title6}

すべての製品オファリングを取得します。

### URL 形式

デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOffering

### サポートされている要求パラメーター {#tmf_prod_cat-GET-prodoffering__section_fcz_2t1_jsb}

{#tmf_prod_cat-GET-prodoffering__table_ofr_vgy_fsb__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 25. パスパラメーター]

{#tmf_prod_cat-GET-prodoffering__table_ofr_vgy_fsb} {#tmf_prod_cat-GET-prodoffering__table_pfr_vgy_fsb__entry__2}

| 名前 | 説明 |
|-|-|
| fields | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効なフィールド： * category * channel * description * externalId * id * internalId * internalVersion * lastUpdate * name * productCharacteristic * productOfferingPrice * productOfferingTerm * productSpecification * prodSpecCharValueUse * validFor * version {#tmf_prod_cat-GET-prodoffering__ul_irb_sdg_5tb} デフォルト：すべてのフィールドを返します。 データタイプ：文字列 |
| limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、offset パラメーターを使用してレコード取得をページネーションします。 デフォルト：20 最大：100 データタイプ：数値 |
| offset | レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 デフォルト：0 データタイプ：数値 |
| specification | 製品仕様 sys_id で製品オファリングをフィルタリングします。指定された製品仕様 sys_id を持つ製品オファリングのみが応答で返されます。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| state | 製品オファリングをステータス別にフィルタリングします。指定されたステータスの製品オファリングのみが応答で返されます。 受け入れ可能な値: * archived * ドラフト * published * 引退 {#tmf_prod_cat-GET-prodoffering__ul_ndy_pcb_ccc} データタイプ：文字列 |
[表 : 26. クエリパラメータ]

{#tmf_prod_cat-GET-prodoffering__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodoffering__table_gld_vkz_gsb__entry__2}

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

{#tmf_prod_cat-GET-prodoffering__table_gld_vkz_gsb}

### ヘッダー

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

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 28. 要求ヘッダー]

{#tmf_prod_cat-GET-prodoffering__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodoffering__table_ug4_sgm_lsb__entry__2}{#tmf_prod_cat-GET-prodoffering__content-range-row}{#tmf_prod_cat-GET-prodoffering__content-type-row}{#tmf_prod_cat-GET-prodoffering__links-pagination-row}{#tmf_prod_cat-GET-prodoffering__x-total-count-descr}

| ヘッダー | 説明 |
|-|-|
| Content-Range | ページネーションされた呼び出しで返されるコンテンツの範囲を指定します。 たとえば、`offset=2` および `limit=3` の場合、Content-Range ヘッダーの値は `items 3-5` です。 |
| Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Link | クエリー結果内を移動するための次のリンクが含まれています。 * first * last * next * previous {#tmf_prod_cat-GET-prodoffering__ul_zzk_sdm_lsb} |
| X-Total-Count | ページネーションされたクエリの場合、このヘッダーはサーバーで利用可能なレコードの合計数を指定します。 |
[表 : 29. 応答ヘッダー]

{#tmf_prod_cat-GET-prodoffering__table_ug4_sgm_lsb}

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 要求が正常に処理されました。応答で完全なリソースが返されました (ページネーションなし)。 |
| 206 | 応答で部分的なリソースが返されました (ページネーションあり)。 |
| 400 | 要求が正しくありません。考えられる理由： * 無効なパスパラメーター * 無効な URI {#tmf_prod_cat-GET-prodoffering__ul_rys_1gy_fsb} |
| 404 | レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。 |
[表 : 30. ステータスコード]

{#tmf_prod_cat-GET-prodoffering__table_qhs_scm_lsb}

### 応答本文のパラメーター (JSON) {#tmf_prod_cat-GET-prodoffering__section_qqr_2s1_jsb}

{#tmf_prod_cat-GET-prodoffering__table_rqr_2s1_jsb__entry__2}

| 名前 | 説明 |
|-|-|
| category | 製品が属するカテゴリのリスト。 データタイプ：オブジェクトのアレイ "category:" [ { "id": "String", "name": "String" } ] |
| category.id | カテゴリの ID。 データタイプ：文字列 |
| category.name | カテゴリの名前。 データタイプ：文字列 |
| channel | 製品オファリングの販売に使用するチャネル。 データタイプ：オブジェクトのアレイ "channel:" [ { "description": "String", "id": "String", "name": "String" } ] |
| channel.description | チャネルの説明。 データタイプ：文字列 |
| channel.id | 流通チャネル \[sn_prd_pm_distribution_channel\] テーブルのチャネルの sys_id。 データタイプ：文字列 |
| channel.name | チャネルの名前。 データタイプ：文字列 |
| description | 製品オファリングの説明。 データタイプ：文字列 |
| externalId | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのexternal_id。 データタイプ：文字列 |
| href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 |
| id | 必須。製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのinitial_versionまたはexternal_id。 データタイプ：文字列 |
| internalId | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのinitial_version。 データタイプ：文字列 |
| internalVersion | 製品オファリング \[sn_prd_pm_product_offering\] テーブルの製品オファリングのバージョン。 データタイプ：文字列 |
| lastUpdate | 製品オファリングが最後に更新された日付。 データタイプ：文字列 |
| ライフサイクルステータス | 製品オファリングの現在のライフサイクルステータス。 受け入れ可能な値: * アクティブ * 非アクティブ * ドラフト {#tmf_prod_cat-GET-prodoffering__ul_vrb_d35_dcc} データタイプ：文字列 デフォルト：空白の文字列 |
| name | 製品オファリングの名前。 データタイプ：文字列 |
| productCharacteristic | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 |
| productOfferingPrice | 製品オファリングの価格情報。 データタイプ：オブジェクトのアレイ "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] |
| productOfferingPrice.price | 製品オファリングの価格情報。 データタイプ：オブジェクト "price": { "taxIncludedAmount": {Object} } |
| productOfferingPrice.price.taxIncludedAmount | 製品オファリングの価格情報。 データタイプ：オブジェクト "taxIncludedAmount": { "unit": "String", "value": "String" } |
| productOfferingPrice.price.taxIncludedAmount.unit | 製品オファリング価格の通貨コード。 データタイプ：文字列 |
| productOfferingPrice.price.taxIncludedAmount.value | 税込みの製品オファリングの価格。 データタイプ：文字列 |
| productOfferingPrice.priceType | 製品オファリング価格のタイプ (1 回払いまたは繰り返し支払い)。 有効な値： * nonRecurring (1 回) * recurring データタイプ：文字列 |
| productOfferingTerm | 製品オファリングの有効な契約期間。 データタイプ：文字列 |
| productSpecification | 製品の製品仕様。 データタイプ：オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | 製品仕様のinitial_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.internalId | 製品仕様のinitial_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.internalVersion | 製品仕様のバージョン。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.version | 製品仕様のexternal_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| prodSpecCharValueUse | 製品オファリング特性。 データタイプ：オブジェクトのアレイ "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue | 特性の可能な値。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | 特性の値。 データタイプ：文字列 |
| prodSpecCharValueUse.description | 特性の説明。 データタイプ：文字列 |
| prodSpecCharValueUse.name | 特性の名前。 データタイプ：文字列 |
| prodSpecCharValueUse.validFor | 特性が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| prodSpecCharValueUse.validFor.endDateTime | 特性の終了日。 データタイプ：文字列 |
| prodSpecCharValueUse.validFor.startDateTime | 特性の開始日。 データタイプ：文字列 |
| prodSpecCharValueUse.valueType | 特性の値タイプ (選択肢やメールなど)。 |
| validFor | 製品オファリングが有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| validFor.endDateTime | 製品オファリングの終了日。 データタイプ：文字列 |
| validFor.startDateTime | 製品オファリングの開始日。 データタイプ：文字列 |
| version | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのexternal_version。 データタイプ：文字列 |
[ ]

{#tmf_prod_cat-GET-prodoffering__table_rqr_2s1_jsb}  

### cURL 要求

この例では、すべての製品オファリングを取得します。

    curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productOffering" \
    --user 'username':'password'

応答本文：

    [
       {
          "id": "24413",
          "name": "Premium SD-WAN Offering New",
          "version": "",
          "internalVersion": "1",
          "internalId": "0199f8e65b430110235d85cced81c7d2",
          "description": "Premium SD-WAN Offering",
          "lastUpdate": "2022-01-27 05:41:16",
          "validFor": {
             "startDateTime": "2021-08-05",
             "endDateTime": "2026-09-04"
          },
          "productOfferingTerm": "not_applicable",
          "productOfferingPrice": [
             {
                "priceType": "recurring",
                "price": {
                   "taxIncludedAmount": {
                      "unit": "JPY",
                      "value": 984.0913
                   }
                }
             },
             {
                "priceType": "nonRecurring",
                "price": {
                   "taxIncludedAmount": {
                      "unit": "GBP",
                      "value": 2434
                   }
                }
             }
          ],
          "productSpecification": {
             "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
             "name": "SD-WAN Service Package",
             "version": "v1",
             "internalVersion": "1",
             "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
          },
          "prodSpecCharValueUse": [
             {
                "name": "Routing",
                "description": "Routing",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2021-12-15 21:08:20"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "Premium",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Base",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Advance",
                      "validFor": {
                         "startDateTime": ""
                      }
                   }
                ],
                "productSpecification": {
                   "id": "39b627aa53702010cd6dddeeff7b1202",
                   "name": "SD-WAN Edge Device",
                   "version": "v1",
                   "internalVersion": "1",
                   "internalId": "39b627aa53702010cd6dddeeff7b1202"
                }
             },
             {
                "name": "WAN Optimization",
                "description": "WAN Optimization",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2021-12-15 21:10:28"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "Base",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Advance",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Premium",
                      "validFor": {
                         "startDateTime": ""
                      }
                   }
                ],
                "productSpecification": {
                   "id": "39b627aa53702010cd6dddeeff7b1202",
                   "name": "SD-WAN Edge Device",
                   "version": "v1",
                   "internalVersion": "1",
                   "internalId": "39b627aa53702010cd6dddeeff7b1202"
                }
             },
             {
                "name": "CPE Model",
                "description": "CPE Model",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2021-12-15 21:11:54"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "ISR",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "ASR",
                      "validFor": {
                         "startDateTime": ""
                      }
                   }
                ],
                "productSpecification": {
                   "id": "39b627aa53702010cd6dddeeff7b1202",
                   "name": "SD-WAN Edge Device",
                   "version": "v1",
                   "internalVersion": "1",
                   "internalId": "39b627aa53702010cd6dddeeff7b1202"
                }
             },
             {
                "name": "Security Type",
                "description": "Security Type",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2021-12-30 12:51:13"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "Premium",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Advance",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Base",
                      "validFor": {
                         "startDateTime": ""
                      }
                   }
                ],
                "productSpecification": {
                   "id": "a6514bd3534560102f18ddeeff7b1247",
                   "name": "SD-WAN Security",
                   "version": "v1",
                   "internalVersion": "1",
                   "internalId": "a6514bd3534560102f18ddeeff7b1247"
                }
             },
             {
                "name": "CPE Type",
                "description": "CPE Type",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2021-12-15 21:11:16"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "Virtual",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Physical",
                      "validFor": {
                         "startDateTime": ""
                      }
                   }
                ],
                "productSpecification": {
                   "id": "39b627aa53702010cd6dddeeff7b1202",
                   "name": "SD-WAN Edge Device",
                   "version": "v1",
                   "internalVersion": "1",
                   "internalId": "39b627aa53702010cd6dddeeff7b1202"
                }
             },
             {
                "name": "Tenancy",
                "description": "Tenancy",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2021-12-15 21:04:24"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "Advance (50 site)",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Base (10 site)",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Premium (>50 sites)",
                      "validFor": {
                         "startDateTime": ""
                      }
                   }
                ],
                "productSpecification": {
                   "id": "216663aa53702010cd6dddeeff7b12b5",
                   "name": "SD-WAN Controller",
                   "version": "v1",
                   "internalVersion": "1",
                   "internalId": "216663aa53702010cd6dddeeff7b12b5"
                }
             }
          ],
          "channel": [
             {
                "id": "e561aae4c3e710105252716b7d40dd8f",
                "name": "Web"
             }
          ],
          "category": {
             "id": "c0ed043653b02010cd6dddeeff7b1277",
             "name": "SD-WAN"
          }
       }
    ]

## 製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productOffering/{id} {#ariaid-title7}

製品オファリングを取得します。

### URL 形式

デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOffering/{id}

### サポートされている要求パラメーター {#tmf_prod_cat-GET-prodoffering-id__section_jjg_dr1_jsb}

{#tmf_prod_cat-GET-prodoffering-id__table_apt_nkz_gsb__entry__2}

| 名前 | 説明 |
|-|-|
| id | 取得する製品オファリングの initial_version。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 |
[表 : 31. パスパラメーター]

{#tmf_prod_cat-GET-prodoffering-id__table_apt_nkz_gsb} {#tmf_prod_cat-GET-prodoffering-id__table_pfr_vgy_fsb__entry__2}

| 名前 | 説明 |
|-|-|
| fields | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効なフィールド： * category * channel * description * externalId * id * internalId * internalVersion * lastUpdate * name * productCharacteristic * productOfferingPrice * productOfferingTerm * productSpecification * prodSpecCharValueUse * validFor * version {#tmf_prod_cat-GET-prodoffering-id__ul_irb_sdg_5tb} デフォルト：すべてのフィールドを返します。 データタイプ：文字列 |
| specification | 製品仕様 sys_id で製品オファリングをフィルタリングします。指定された製品仕様 sys_id を持つ製品オファリングのみが応答で返されます。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| state | 製品オファリングをステータス別にフィルタリングします。指定されたステータスの製品オファリングのみが応答で返されます。 受け入れ可能な値: * archived * ドラフト * published * 引退 {#tmf_prod_cat-GET-prodoffering-id__ul_ndy_pcb_ccc} データタイプ：文字列 |
[表 : 32. クエリパラメーター]

{#tmf_prod_cat-GET-prodoffering-id__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodoffering-id__table_gld_vkz_gsb__entry__2}

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

{#tmf_prod_cat-GET-prodoffering-id__table_gld_vkz_gsb}

### ヘッダー

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

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 34. 要求ヘッダー]

{#tmf_prod_cat-GET-prodoffering-id__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodoffering-id__table_tzy_thy_ksb__entry__2}

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

{#tmf_prod_cat-GET-prodoffering-id__table_tzy_thy_ksb}

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。考えられる理由： * 無効なパスパラメーター * 無効な URI {#tmf_prod_cat-GET-prodoffering-id__ul_rys_1gy_fsb} |
| 404 | 見つかりません。要求アイテムが見つかりませんでした。 |
[表 : 36. ステータスコード]

{#tmf_prod_cat-GET-prodoffering-id__table_nxj_ykz_gsb}

### 応答本文のパラメーター (JSON) {#tmf_prod_cat-GET-prodoffering-id__section_qqr_2s1_jsb}

{#tmf_prod_cat-GET-prodoffering-id__table_rqr_2s1_jsb__entry__2}

| 名前 | 説明 |
|-|-|
| category | 製品が属するカテゴリのリスト。 データタイプ：アレイ "category:" [ { "id": "String", "name": "String" } ] |
| category.id | カテゴリの id。 データタイプ：文字列 |
| category.name | カテゴリの名前。 データタイプ：文字列 |
| channel | 製品オファリングの販売に使用するチャネル。 データタイプ：アレイ "channel:" [ { "description": "String", "id": "String", "name": "String" } ] |
| channel.description | チャネルの説明。 データタイプ：文字列 |
| channel.id | 流通チャネル \[sn_prd_pm_distribution_channel\] テーブルのチャネルの sys_id。 データタイプ：文字列 |
| channel.name | チャネルの名前。 データタイプ：文字列 |
| description | 製品オファリングの説明。 データタイプ：文字列 |
| externalId | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのexternal_id。 データタイプ：文字列 |
| href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 |
| id | 必須。製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのinitial_versionまたはexternal_id。 データタイプ：文字列 |
| internalId | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのinitial_version。 データタイプ：文字列 |
| internalVersion | 製品オファリング \[sn_prd_pm_product_offering\] テーブルの製品オファリングのバージョン。 データタイプ：文字列 |
| lastUpdate | 製品オファリングが最後に更新された日付。 データタイプ：文字列 |
| ライフサイクルステータス | 製品オファリングの現在のライフサイクルステータスを示します。受け入れ可能な値: * アクティブ * 非アクティブ * ドラフト {#tmf_prod_cat-GET-prodoffering-id__ul_lj5_gg4_4bc} データタイプ：文字列 デフォルト：空白の文字列 |
| name | 製品オファリングの名前。 データタイプ：文字列 |
| productCharacteristic | 製品特性のリスト。 データタイプ：アレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 |
| productOfferingPrice | 製品オファリングの価格情報。 データタイプ：アレイ "productOfferingPrice": [ { "price": Object, "priceType": "String" } ] |
| productOfferingPrice.price | 製品オファリングの価格情報。 データタイプ：オブジェクト "price": { "taxIncludedAmount": Object } |
| productOfferingPrice.price.taxIncludedAmount | 製品オファリングの価格情報。 データタイプ：オブジェクト "taxIncludedAmount": { "unit": "String", "value": "String" } |
| productOfferingPrice.price.taxIncludedAmount.unit | 製品オファリング価格の通貨コード。 データタイプ：文字列 |
| productOfferingPrice.price.taxIncludedAmount.value | 税込みの製品オファリングの価格。 データタイプ：文字列 |
| productOfferingPrice.priceType | 製品オファリング価格が 1 回払いまたは繰り返し支払いであるかを識別します。 有効な値： * nonRecurring * recurring {#tmf_prod_cat-GET-prodoffering-id__ul_nl4_jqh_hsb} データタイプ：文字列 |
| productOfferingTerm | 製品オファリングの有効な契約期間。 データタイプ：文字列 |
| productSpecification | 製品の製品仕様。 データタイプ：オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | 製品仕様のinitial_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.internalId | 製品仕様のinitial_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.internalVersion | 製品仕様のバージョン。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.version | 製品仕様のexternal_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| prodSpecCharValueUse | 製品オファリング特性。 データタイプ：アレイ "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": Array, "description": "String", "name": "String", "validFor": Object, "valueType": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue | 特性の可能な値を含むアレイ。 データタイプ：アレイ "productSpecCharacteristicValue": [ { "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | 特性の値。 データタイプ：文字列 |
| prodSpecCharValueUse.description | 特性の説明。 データタイプ：文字列 |
| prodSpecCharValueUse.name | 特性の名前。 データタイプ：文字列 |
| prodSpecCharValueUse.validFor | 特性が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| prodSpecCharValueUse.validFor.endDateTime | 特性の終了日。 データタイプ：文字列 |
| prodSpecCharValueUse.validFor.startDateTime | 特性の開始日。 データタイプ：文字列 |
| prodSpecCharValueUse.valueType | 特性の値タイプ (選択肢やメールなど)。 |
| validFor | 製品オファリングが有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| validFor.endDateTime | 製品オファリングの終了日。 データタイプ：文字列 |
| validFor.startDateTime | 製品オファリングの開始日。 データタイプ：文字列 |
| version | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのexternal_version。 データタイプ：文字列 |
[ ]

{#tmf_prod_cat-GET-prodoffering-id__table_rqr_2s1_jsb}  

### cURL 要求

この例では、製品オファリングを取得します。

    curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productOffering/24413" \
    --user 'username':'password'

応答本文：

    {
       "id": "24413",
       "name": "Premium SD-WAN Offering New",
       "description": "Premium SD-WAN Offering",
       "lastUpdate": "2022-01-27 05:41:16",
       "version": "",
       "internalVersion": "2",
       "internalId": "69017a0f536520103b6bddeeff7b127d",
       "validFor": {
          "startDateTime": "2021-08-05",
          "endDateTime": "2026-09-04"
       },
       "productOfferingTerm": "not_applicable",
       "productOfferingPrice": [
          {
             "priceType": "recurring",
             "price": {
                "taxIncludedAmount": {
                   "unit": "JPY",
                   "value": 984.0913
                }
             }
          },
          {
             "priceType": "nonRecurring",
             "price": {
                "taxIncludedAmount": {
                   "unit": "GBP",
                   "value": 2434
                }
             }
          }
       ],
       "productSpecification": {
          "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
          "name": "SD-WAN Service Package",
          "version": "v1",
          "internalVersion": "1",
          "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
       },
       "prodSpecCharValueUse": [
          {
             "name": "Routing",
             "description": "Routing",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-12-15 21:08:20"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v2",
                "internalVersion": "2",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "WAN Optimization",
             "description": "WAN Optimization",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-12-15 21:10:28"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v2",
                "internalVersion": "2",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "CPE Model",
             "description": "CPE Model",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-12-15 21:11:54"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "ISR",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "ASR",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v2",
                "internalVersion": "2",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "Security Type",
             "description": "Security Type",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-12-30 12:51:13"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "a6514bd3534560102f18ddeeff7b1247",
                "name": "SD-WAN Security",
                "version": "abc",
                "internalVersion": "1",
                "internalId": "a6514bd3534560102f18ddeeff7b1247"
             }
          },
          {
             "name": "CPE Type",
             "description": "CPE Type",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-12-15 21:11:16"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Virtual",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Physical",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "",
                "internalVersion": "2",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "Tenancy",
             "description": "Tenancy",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-12-15 21:04:24"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Advance (50 site)",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base (10 site)",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Premium (>50 sites)",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "216663aa53702010cd6dddeeff7b12b5",
                "name": "SD-WAN Controller",
                "version": "",
                "internalVersion": "1",
                "internalId": "216663aa53702010cd6dddeeff7b12b5"
             }
          }
       ],
       "channel": [
          {
             "id": "e561aae4c3e710105252716b7d40dd8f",
             "name": "Web"
          }
       ],
       "category": {
          "id": "c0ed043653b02010cd6dddeeff7b1277",
          "name": "SD-WAN"
       }
    }

## 製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productSpecification {#ariaid-title8}

すべての製品仕様を取得します。

### URL 形式

デフォルト URL: /api/sn_tmf_api/catalogmanagement/productSpecification

### サポートされている要求パラメーター {#tmf_prod_cat-GET-prodspec__section_fcz_2t1_jsb}

{#tmf_prod_cat-GET-prodspec__table_ofr_vgy_fsb__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 37. パスパラメーター]

{#tmf_prod_cat-GET-prodspec__table_ofr_vgy_fsb} {#tmf_prod_cat-GET-prodspec__table_pfr_vgy_fsb__entry__2}

| 名前 | 説明 |
|-|-|
| fields | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効なフィールド： * description * externalId * id * internalId * internalVersion * lastUpdate * name * productSpecCharacteristic * productSpecificationRelationship * resourceSpecification * serviceSpecification * validFor * version {#tmf_prod_cat-GET-prodspec__ul_n1h_htz_54b} デフォルト：すべてのフィールドを返します。 データタイプ：文字列 |
| limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、offset パラメーターを使用してレコード取得をページネーションします。 デフォルト：20 最大：100 データタイプ：数値 |
| offset | レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 デフォルト：0 データタイプ：数値 |
| state | 製品仕様をステータス別にフィルタリングします。指定されたステータスの製品仕様のみが応答で返されます。 受け入れ可能な値: * archived * ドラフト * published * 引退 {#tmf_prod_cat-GET-prodspec__ul_ngb_qcb_ccc} データタイプ：文字列 |
[表 : 38. クエリパラメータ]

{#tmf_prod_cat-GET-prodspec__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodspec__table_gld_vkz_gsb__entry__2}

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

{#tmf_prod_cat-GET-prodspec__table_gld_vkz_gsb}

### ヘッダー

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

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 40. 要求ヘッダー]

{#tmf_prod_cat-GET-prodspec__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodspec__table_pkr_rgm_lsb__entry__2}{#tmf_prod_cat-GET-prodspec__content-range-row}{#tmf_prod_cat-GET-prodspec__content-type-row}{#tmf_prod_cat-GET-prodspec__links-pagination-row}{#tmf_prod_cat-GET-prodspec__x-total-count-descr}

| ヘッダー | 説明 |
|-|-|
| Content-Range | ページネーションされた呼び出しで返されるコンテンツの範囲を指定します。 たとえば、`offset=2` および `limit=3` の場合、Content-Range ヘッダーの値は `items 3-5` です。 |
| Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Link | クエリー結果内を移動するための次のリンクが含まれています。 * first * last * next * previous {#tmf_prod_cat-GET-prodspec__ul_zzk_sdm_lsb} |
| X-Total-Count | ページネーションされたクエリの場合、このヘッダーはサーバーで利用可能なレコードの合計数を指定します。 |
[表 : 41. 応答ヘッダー]

{#tmf_prod_cat-GET-prodspec__table_pkr_rgm_lsb}

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 要求が正常に処理されました。応答で完全なリソースが返されました (ページネーションなし)。 |
| 206 | 応答で部分的なリソースが返されました (ページネーションあり)。 |
| 400 | 要求が正しくありません。考えられる理由： * 無効なパスパラメーター * 無効な URI {#tmf_prod_cat-GET-prodspec__ul_rys_1gy_fsb} |
| 404 | レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。 |
[表 : 42. ステータスコード]

{#tmf_prod_cat-GET-prodspec__table_xss_rcm_lsb}

### 応答本文のパラメーター (JSON) {#tmf_prod_cat-GET-prodspec__section_ymb_ccb_jsb}

{#tmf_prod_cat-GET-prodspec__table_zmb_ccb_jsb__entry__2}

| 名前 | 説明 |
|-|-|
| description | 仕様の説明。 データタイプ：文字列 |
| externalId | 必須。製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の external_id。 データタイプ：文字列 |
| href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 |
| id | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の initial_version または external_id。 データタイプ：文字列 |
| internalId | 必須。製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の initial_version。 データタイプ：文字列 |
| internalVersion | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様のバージョン。 データタイプ：文字列 |
| isBundle | productSpecificationが単一の製品を表すか、製品のバンドルを表すかを示すフラグ。 有効な値： * true:製品仕様は製品バンドルであり、複数の製品が含まれています。 * false:製品仕様には単一の製品が含まれています。 {#tmf_prod_cat-GET-prodspec__ul_rry_rz4_4bc} データタイプ：ブーリアン デフォルト値：false |
| lastUpdate | 仕様が最後に更新された日付。 データタイプ：文字列 |
| ライフサイクルステータス | 製品仕様の現在のライフサイクルステータス。 受け入れ可能な値: * アクティブ * 非アクティブ * ドラフト {#tmf_prod_cat-GET-prodspec__ul_lj5_gg4_4bc} データタイプ：文字列 デフォルト：空白の文字列 |
| name | 仕様の名前。 データタイプ：文字列 |
| productSpecCharacteristic | 仕様特性。 データタイプ：オブジェクトのアレイ "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] |
| productSpecCharacteristic.description | 特性の説明。 データタイプ：文字列 |
| productSpecCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productSpecCharacteristic.productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "value": "String" } ] |
| productSpecCharacteristic.productSpecCharacteristicValue.value | 特性の値。 データタイプ：文字列 |
| productSpecCharacteristic.validFor | 特性が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| productSpecCharacteristic.validFor.endDateTime | 特性の終了日。 データタイプ：文字列 |
| productSpecCharacteristic.validFor.startDateTime | 特性の開始日。 データタイプ：文字列 |
| productSpecCharacteristic.valueType | 特性の値タイプ (選択肢やメールなど)。 データタイプ：文字列 |
| productSpecificationRelationship | この仕様と他の製品仕様との関係。 データタイプ：オブジェクトのアレイ "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": {Object} } ] |
| productSpecificationRelationship.id | 関連仕様の ID。 データタイプ：文字列 |
| productSpecificationRelationship.type | 関係のタイプ。 データタイプ：文字列 |
| productSpecificationRelationship.validFor | 関係が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| productSpecificationRelationship.validFor.endDateTime | 関係の終了日。 データタイプ：文字列 |
| productSpecificationRelationship.validFor.startDateTime | 関係の開始日。 データタイプ：文字列 |
| resourceSpecification | この製品仕様に関連するリソース仕様のリスト。 データタイプ：オブジェクトのアレイ "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| resourceSpecification.id | リソース仕様の initial_version または external_id。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの sys_id または external_id フィールドにあります。 データタイプ：文字列 |
| resourceSpecification.internalId | リソース仕様の initial_version。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.internalVersion | リソース仕様のバージョン。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.name | リソース仕様の名前。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.version | リソース仕様の external_version。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification | この製品仕様に関連するサービス仕様のリスト。 データタイプ：オブジェクトのアレイ "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| serviceSpecification.id | サービス仕様の initial_version または external_id。サービス仕様 \[sn_prd_pm_service_specification\] テーブルの sys_id または external_id フィールドにあります。 データタイプ：文字列 |
| serviceSpecification.internalId | サービス仕様の initial_version。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.internalVersion | サービス仕様のバージョン。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.name | サービス仕様の名前。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.version | サービス仕様の external_version。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| validFor | 仕様が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| validFor.endDateTime | 仕様の終了日。 データタイプ：文字列 |
| validFor.startDateTime | 仕様の開始日。 データタイプ：文字列 |
| version | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の external_version。 データタイプ：文字列 |
[ ]

{#tmf_prod_cat-GET-prodspec__table_zmb_ccb_jsb}  

### cURL 要求

この例では、すべての製品仕様を取得します。

    curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification" \
    --user 'username':'password'

応答本文：

    [
       {
          "id": "0c47f2257441c110f877ca57242ff9bd",
          "name": "SD-WAN My Device",
          "version": "v1",
          "internalVersion": "1",
          "internalId": "0c47f2257441c110f877ca57242ff9bd",
          "description": "This is my product specification ...",
          "lastUpdate": "2022-01-14 17:57:23",
          "validFor": {
             "startDateTime": "2022-01-11",
             "endDateTime": "2027-01-10"
          },
          "serviceSpecification": [
             {
                "id": "e23ae2d01bb420106ba59acf034bcb56",
                "name": "IP Sec Tunnel",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "e23ae2d01bb420106ba59acf034bcb56"
             }
          ],
          "productSpecificationRelationship": [
             {
                "id": "a6514bd3534560102f18ddeeff7b1247",
                "name": "SD-WAN Security",
                "version": "1",
                "type": "Service",
                "validFor": {
                   "startDateTime": "2022-01-11",
                   "endDateTime": "2027-02-12"
                }
             }
          ],
          "resourceSpecification": [
             {
                "id": "493fa60b536520103b6bddeeff7b12b6",
                "name": "Customer Premise SD-WAN Router",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "493fa60b536520103b6bddeeff7b12b6"
             }
          ],
          "productSpecCharacteristic": [
             {
                "name": "New characteristic",
                "description": "This product has new spec characteristic.",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2022-01-13 06:47:43"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "TestValue",
                      "validFor": {
                         "startDateTime": "2022-01-11"
                      }
                   }
                ]
             }
          ]
       }
    ]

## 製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productSpecification/{id} {#ariaid-title9}

指定された製品仕様を取得します。

### URL 形式

デフォルト URL: /api/sn_tmf_api/catalogmanagement/productSpecification/{id}

### サポートされている要求パラメーター {#tmf_prod_cat-GET-prodspec-id__section_jjg_dr1_jsb}

{#tmf_prod_cat-GET-prodspec-id__table_apt_nkz_gsb__entry__2}

| 名前 | 説明 |
|-|-|
| specificationId | 取得する製品仕様のinitial_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
[表 : 43. パスパラメーター]

{#tmf_prod_cat-GET-prodspec-id__table_apt_nkz_gsb} {#tmf_prod_cat-GET-prodspec-id__table_pfr_vgy_fsb__entry__2}

| 名前 | 説明 |
|-|-|
| fields | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効なフィールド： * description * externalId * id * internalId * internalVersion * lastUpdate * name * productSpecCharacteristic * productSpecificationRelationship * resourceSpecification * serviceSpecification * validFor * version {#tmf_prod_cat-GET-prodspec-id__ul_n1h_htz_54b} デフォルト：すべてのフィールドを返します。 データタイプ：文字列 |
| state | 製品仕様をステータス別にフィルタリングします。指定されたステータスの製品仕様のみが応答で返されます。 受け入れ可能な値: * archived * ドラフト * published * 引退 {#tmf_prod_cat-GET-prodspec-id__ul_ngb_qcb_ccc} データタイプ：文字列 |
[表 : 44. クエリパラメーター]

{#tmf_prod_cat-GET-prodspec-id__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodspec-id__table_gld_vkz_gsb__entry__2}

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

{#tmf_prod_cat-GET-prodspec-id__table_gld_vkz_gsb}

### ヘッダー

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

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 46. 要求ヘッダー]

{#tmf_prod_cat-GET-prodspec-id__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodspec-id__table_tzy_thy_ksb__entry__2}{#tmf_prod_cat-GET-prodspec-id__content_type-JSON-only-entry-RESTAPI}

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

{#tmf_prod_cat-GET-prodspec-id__table_tzy_thy_ksb}

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。考えられる理由： * 無効なパスパラメーター * 無効な URI {#tmf_prod_cat-GET-prodspec-id__ul_rys_1gy_fsb} |
| 404 | 見つかりません。要求アイテムが見つかりませんでした。 |
[表 : 48. ステータスコード]

{#tmf_prod_cat-GET-prodspec-id__table_nxj_ykz_gsb}

### 応答本文のパラメーター (JSON) {#tmf_prod_cat-GET-prodspec-id__section_ymb_ccb_jsb}

{#tmf_prod_cat-GET-prodspec-id__table_zmb_ccb_jsb__entry__2}

| 名前 | 説明 |
|-|-|
| description | 仕様の説明。 データタイプ：文字列 |
| externalId | 必須。製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の external_id。 データタイプ：文字列 |
| href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 |
| id | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の initial_version または external_id。 データタイプ：文字列 |
| internalId | 必須。製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の initial_version。 データタイプ：文字列 |
| internalVersion | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様のバージョン。 データタイプ：文字列 |
| isBundle | productSpecificationが単一の製品を表すか、製品のバンドルを表すかを示すフラグ。 有効な値： * true:製品仕様は製品バンドルであり、複数の製品が含まれています。 * false:製品仕様には単一の製品が含まれています。 {#tmf_prod_cat-GET-prodspec-id__ul_rry_rz4_4bc} データタイプ：ブーリアン デフォルト値：false |
| lastUpdate | 仕様が最後に更新された日付。 データタイプ：文字列 |
| ライフサイクルステータス | 製品仕様の現在のライフサイクルステータスを示します。 有効な値： * アクティブ * 非アクティブ * ドラフト {#tmf_prod_cat-GET-prodspec-id__ul_lj5_gg4_4bc} データタイプ：文字列 デフォルト：空白の文字列 |
| name | 仕様の名前。 データタイプ：文字列 |
| productSpecCharacteristic | 仕様特性。 データタイプ：オブジェクトのアレイ "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] |
| productSpecCharacteristic.description | 特性の説明。 データタイプ：文字列 |
| productSpecCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productSpecCharacteristic.productSpecCharacteristicValue | 特性の可能な値。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "value": "String" } ] |
| productSpecCharacteristic.productSpecCharacteristicValue.value | 特性の値。 データタイプ：文字列 |
| productSpecCharacteristic.validFor | 特性が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| productSpecCharacteristic.validFor.endDateTime | 特性の終了日。 データタイプ：文字列 |
| productSpecCharacteristic.validFor.startDateTime | 特性の開始日。 データタイプ：文字列 |
| productSpecCharacteristic.valueType | 特性の値タイプ (選択肢やメールなど)。 データタイプ：文字列 |
| productSpecificationRelationship | この仕様と他の製品仕様との関係。 データタイプ：オブジェクトのアレイ "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": {Object} } ] |
| productSpecificationRelationship.id | 関連仕様の ID。 データタイプ：文字列 |
| productSpecificationRelationship.type | 関係のタイプ。 データタイプ：文字列 |
| productSpecificationRelationship.validFor | 関係が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| productSpecificationRelationship.validFor.endDateTime | 関係の終了日。 データタイプ：文字列 |
| productSpecificationRelationship.validFor.startDateTime | 関係の開始日。 データタイプ：文字列 |
| resourceSpecification | この製品仕様に関連するリソース仕様のリスト。 データタイプ：オブジェクトのアレイ "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| resourceSpecification.id | リソース仕様の initial_version または external_id。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの sys_id または external_id フィールドにあります。 データタイプ：文字列 |
| resourceSpecification.internalId | リソース仕様の initial_version。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.internalVersion | リソース仕様のバージョン。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.name | リソース仕様の名前。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.version | リソース仕様の external_version。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification | この製品仕様に関連するサービス仕様のリスト。 データタイプ：オブジェクトのアレイ "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| serviceSpecification.id | サービス仕様の initial_version または external_id。サービス仕様 \[sn_prd_pm_service_specification\] テーブルの sys_id または external_id フィールドにあります。 データタイプ：文字列 |
| serviceSpecification.internalId | サービス仕様の initial_version。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.internalVersion | サービス仕様のバージョン。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.name | サービス仕様の名前。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.version | サービス仕様の external_version。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| validFor | 仕様が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| validFor.endDateTime | 仕様の終了日。 データタイプ：文字列 |
| validFor.startDateTime | 仕様の開始日。 データタイプ：文字列 |
| version | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の external_version。 データタイプ：文字列 |
[ ]

{#tmf_prod_cat-GET-prodspec-id__table_zmb_ccb_jsb}  

### cURL 要求

この例では、製品仕様を取得します。

    curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification/0c47f2257441c110f877ca57242ff9bd" \
    --user 'username':'password'

応答本文：

    {
       "id": "0c47f2257441c110f877ca57242ff9bd",
       "name": "SD-WAN My Device",
       "version": "v1",
       "internalVersion": "1",
       "internalId": "0c47f2257441c110f877ca57242ff9bd",
       "description": "This is my product specification ...",
       "lastUpdate": "2022-01-14 17:57:23",
       "validFor": {
          "startDateTime": "2022-01-11",
          "endDateTime": "2027-01-10"
       },
       "serviceSpecification": [
          {
             "id": "e23ae2d01bb420106ba59acf034bcb56",
             "name": "IP Sec Tunnel",
             "version": "v1",
             "internalVersion": "1",
             "internalId": "e23ae2d01bb420106ba59acf034bcb56"
          }
       ],
       "productSpecificationRelationship": [
          {
             "id": "a6514bd3534560102f18ddeeff7b1247",
             "name": "SD-WAN Security",
             "version": "v1",
             "internalVersion": "1",
             "internalId": " a6514bd3534560102f18ddeeff7b1247",
             "type": "Service",
             "validFor": {
                "startDateTime": "2022-01-11",
                "endDateTime": "2027-02-12"
             }
          }
       ],
       "resourceSpecification": [
          {
             "id": "493fa60b536520103b6bddeeff7b12b6",
             "name": "Customer Premise SD-WAN Router",
             "version": "v1",
             "internalVersion": "1",
             "internalId": "493fa60b536520103b6bddeeff7b12b6"
          }
       ],
       "productSpecCharacteristic": [
          {
             "name": "New characteristic",
             "description": "This product has new spec characteristic.",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2022-01-13 06:47:43"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "TestValue",
                   "validFor": {
                      "startDateTime": "2022-01-11"
                   }
                }
             ]
          }
       ]
    }

## 製品カタログオープン API - PATCH /sn_tmf_api/catalogmanagement/productOffering/{id} {#ariaid-title10}

指定された製品オファリングを更新します。

### URL 形式

デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOffering/{id}

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

{#tmf_prod_cat-PATCH-prodOffering-id__entry__2}

| 名前 | 説明 |
|-|-|
| id | 更新する製品オファリングのSys_id。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 |
[表 : 49. パスパラメーター]

{#tmf_prod_cat-PATCH-prodOffering-id__entry__6}

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

{#tmf_prod_cat-PATCH-prodOffering-id__table_vxh_xvf_hsb__entry__2}

| 名前 | 説明 |
|-|-|
| category | 製品が属するカテゴリのリスト。カテゴリ \[sc_category\] テーブルにあります。 データタイプ：オブジェクトのアレイ "category:" [ { "id": "String", "name": "String" } ] |
| category.id | category パラメーターを使用する場合は必須です。カテゴリの ID。カテゴリ \[sc_category\] テーブルにあります。 データタイプ：文字列 |
| category.name | カテゴリの名前。 データタイプ：文字列 デフォルト：空白の文字列 |
| channel | 必須です。製品オファリングの販売に使用するチャネル。 データタイプ：オブジェクトのアレイ "channel:" [ { "description": "String", "id": "String", "name": "String" } ] |
| channel.description | チャネルの説明。 データタイプ：文字列 デフォルト：空白の文字列 |
| channel.id | 必須です。流通チャネル \[sn_prd_pm_distribution_channel\] テーブルのチャネルの sys_id。 データタイプ：文字列 |
| channel.name | チャネルの名前。 データタイプ：文字列 デフォルト：空白の文字列 |
| description | 必須です。製品オファリングの説明。 データタイプ：文字列 |
| externalId | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのexternal_id。 データタイプ：文字列 |
| id | 必須。製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのinitial_versionまたはexternal_id。 データタイプ：文字列 |
| internalId | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのinitial_version。 データタイプ：文字列 |
| internalVersion | 製品オファリング \[sn_prd_pm_product_offering\] テーブルの製品オファリングのバージョン。 データタイプ：文字列 |
| lastUpdate | 製品オファリングが最後に更新された日付。 形式:YYYY-MM-DD 00:00:00 データタイプ：文字列 デフォルト：空白の文字列 |
| name | 必須です。製品オファリングの名前。 データタイプ：文字列 |
| productCharacteristic | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 デフォルト：空白の文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 デフォルト：空白の文字列 |
| productOfferingPrice | 製品オファリングの価格情報。 データタイプ：オブジェクトのアレイ "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] |
| productOfferingPrice.price | 製品オファリングの価格情報。 データタイプ：オブジェクト "price": { "taxIncludedAmount": {Object} } |
| productOfferingPrice.price.taxIncludedAmount | 製品オファリングの価格情報。 データタイプ：オブジェクト "taxIncludedAmount": { "unit": "String", "value": "String" } |
| productOfferingPrice.price.taxIncludedAmount.unit | 製品オファリング価格の通貨コード。 データタイプ：文字列 デフォルト：空白の文字列 |
| productOfferingPrice.price.taxIncludedAmount.value | 税込みの製品オファリングの価格。10 進数値 (123.45 など) を使用します。 データタイプ：文字列 デフォルト：空白の文字列 |
| productOfferingPrice.priceType | 製品オファリングタイプのタイプ。productOfferingPrice パラメーターを使用する場合は必須です。 有効な値： * nonRecurring (1 回) * recurring {#tmf_prod_cat-PATCH-prodOffering-id__ul_g3z_bcj_4bc} データタイプ：文字列 |
| productOfferingTerm | 製品オファリングの有効な契約期間 (月)。 データタイプ：文字列 デフォルト：空白の文字列 |
| productSpecification | 必須です。製品の製品仕様。 データタイプ：オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | 必須です。製品仕様の initial_version または external_id。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.internalId | 製品仕様のinitial_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.internalVersion | 製品仕様のバージョン。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.version | 製品仕様のexternal_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| prodSpecCharValueUse | 製品オファリングの特性。 データタイプ：オブジェクトのアレイ "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue | 特性の可能な値を含むアレイ。 データタイプ:オブジェクトのアレイ "productSpecCharacteristicValue": [ { "validFor": { "startDateTime": "String" }, "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | 特性の値。 データタイプ：文字列 |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor | 特性が有効になる日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor.startDateTime | 特性が有効になる開始日時。 形式:YYYY-MM-DD 00:00:00 データタイプ：文字列 |
| prodSpecCharValueUse.description | 特性の説明。 データタイプ：文字列 |
| prodSpecCharValueUse.name | 必須です。特性の名前。 データタイプ：文字列 |
| prodSpecCharValueUse.validFor | 特性が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| prodSpecCharValueUse.validFor.endDateTime | 特性の終了日時。 形式:YYYY-MM-DD 00:00:00 データタイプ：文字列 |
| prodSpecCharValueUse.validFor.startDateTime | 特性の開始日時 形式:YYYY-MM-DD 00:00:00 データタイプ：文字列 |
| prodSpecCharValueUse.valueType | 特性の値タイプ (選択肢やメールなど)。 データタイプ：文字列 |
| validFor | 必須です。製品オファリングが有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| validFor.endDateTime | 必須。製品オファリングの終了日時。 形式:YYYY-MM-DD 00:00:00 データタイプ：文字列 |
| validFor.startDateTime | 必須。製品オファリングの開始日時。 形式:YYYY-MM-DD 00:00:00 データタイプ：文字列 |
| version | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのexternal_version。 データタイプ：文字列 |
[表 : 51. 要求本文パラメーター (JSON)]

{#tmf_prod_cat-PATCH-prodOffering-id__table_vxh_xvf_hsb}

### 応答本文のパラメーター (JSON) {#tmf_prod_cat-PATCH-prodOffering-id__section_cjr_vbj_4bc}

### ヘッダー

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

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

{#tmf_prod_cat-PATCH-prodOffering-id__entry__106}

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

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 404 | 見つかりません。要求アイテムが見つかりませんでした。 |
[表 : 54. ステータスコード]

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

{#tmf_prod_cat-PATCH-prodOffering-id__table_bts_ybj_4bc__entry__2}

| 名前 | 説明 |
|-|-|
| category | 製品が属するカテゴリのリスト。 データタイプ：オブジェクトのアレイ "category:" [ { "id": "String", "name": "String" } ] |
| category.id | カテゴリの ID。 データタイプ：文字列 |
| category.name | カテゴリの名前。 データタイプ：文字列 |
| channel | 製品オファリングの販売に使用するチャネル。 データタイプ：オブジェクトのアレイ "channel:" [ { "description": "String", "id": "String", "name": "String" } ] |
| channel.description | チャネルの説明。 データタイプ：文字列 |
| channel.id | 流通チャネル \[sn_prd_pm_distribution_channel\] テーブルのチャネルの sys_id。 データタイプ：文字列 |
| channel.name | チャネルの名前。 データタイプ：文字列 |
| description | 製品オファリングの説明。 データタイプ：文字列 |
| externalId | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのexternal_id。 データタイプ：文字列 |
| href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 |
| id | 必須。製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのinitial_versionまたはexternal_id。 データタイプ：文字列 |
| internalId | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのinitial_version。 データタイプ：文字列 |
| internalVersion | 製品オファリング \[sn_prd_pm_product_offering\] テーブルの製品オファリングのバージョン。 データタイプ：文字列 |
| lastUpdate | 製品オファリングが最後に更新された日付。 データタイプ：文字列 |
| リフトサイクルステータス | 現在のライフサイクルステータスを示します。受け入れ可能な値: * アクティブ * ドラフト * 非アクティブ {#tmf_prod_cat-PATCH-prodOffering-id__ul_lj5_gg4_4bc} データタイプ：文字列 デフォルト：空白の文字列 |
| name | 製品オファリングの名前。 データタイプ：文字列 |
| productCharacteristic | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 |
| productOfferingPrice | 製品オファリングの価格情報。 データタイプ：オブジェクトのアレイ "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] |
| productOfferingPrice.price | 製品オファリングの価格情報。 データタイプ：オブジェクト "price": { "taxIncludedAmount": {Object} } |
| productOfferingPrice.price.taxIncludedAmount | 製品オファリングの価格情報。 データタイプ：オブジェクト "taxIncludedAmount": { "unit": "String", "value": "String" } |
| productOfferingPrice.price.taxIncludedAmount.unit | 製品オファリング価格の通貨コード。 データタイプ：文字列 |
| productOfferingPrice.price.taxIncludedAmount.value | 税込みの製品オファリングの価格。 データタイプ：文字列 |
| productOfferingPrice.priceType | 製品オファリングの価格タイプ (1 回払いまたは繰り返し支払い)。可能な値: * nonRecurring (1 回) * recurring {#tmf_prod_cat-PATCH-prodOffering-id__ul_cts_ybj_4bc} データタイプ：文字列 |
| productOfferingTerm | 製品オファリングの有効な契約期間。 データタイプ：文字列 |
| productSpecification | 製品の製品仕様。 データタイプ：オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | 製品仕様のinitial_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.internalId | 製品仕様のinitial_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.internalVersion | 製品仕様のバージョン。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.version | 製品仕様のexternal_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| prodSpecCharValueUse | 製品オファリング特性。 データタイプ：オブジェクトのアレイ "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": [Array], "description": "String", "name": "String", "validFor": {Object} "productSpecCharacteristicValue": [Array], "valueType": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue | 特性の可能な値を含むアレイ。 データタイプ:オブジェクトのアレイ "productSpecCharacteristicValue": [ { "validFor": { "startDateTime": "String" }, "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | 特性の値。 データタイプ：文字列 |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor | 特性が有効になる日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor.startDateTime | 特性が有効になる開始日時。 形式:YYYY-MM-DD 00:00:00 データタイプ：文字列 |
| prodSpecCharValueUse.description | 特性の説明。 データタイプ：文字列 |
| prodSpecCharValueUse.name | 特性の名前。 データタイプ：文字列 |
| prodSpecCharValueUse.validFor | 特性が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| prodSpecCharValueUse.validFor.endDateTime | 特性の終了日。 データタイプ：文字列 |
| prodSpecCharValueUse.validFor.startDateTime | 特性の開始日。 データタイプ：文字列 |
| prodSpecCharValueUse.valueType | 特性の値タイプ (選択肢やメールなど)。 |
| validFor | 製品オファリングが有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| validFor.endDateTime | 製品オファリングの終了日。 データタイプ：文字列 |
| validFor.startDateTime | 製品オファリングの開始日。 データタイプ：文字列 |
| version | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのexternal_version。 データタイプ：文字列 |
[ ]

{#tmf_prod_cat-PATCH-prodOffering-id__table_bts_ybj_4bc}  

### cURL 要求

次の例では、ID d6f8d9995b020210235d85cced81c7eb の製品オファリングを、要求本文で提供された情報で更新します。

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOffering/d6f8d9995b020210235d85cced81c7eb" \ 
    --request PATCH\ 
    --header "Accept:application/json" \ 
    --user 'username':'password'
    --data '{
      "name": "Offering 1",
      "displayName": "Offering 1",
      "description": "Offering 1 desc",
      "lastUpdate": "2024-04-01 16:05:19",
      "version": "Offering 1 EXTV",
      "validFor": {
        "startDateTime": "2028-02-29",
        "endDateTime": "2033-03-30"
      },
      "productOfferingTerm": "12_months",
      "productOfferingPrice": [
        {
          "priceType": "recurring",
          "price": {
            "taxIncludedAmount": {
              "unit": "USD",
              "value": 632.1483
            }
          }
        },
        {
          "priceType": "nonRecurring",
          "price": {
            "taxIncludedAmount": {
              "unit": "USD",
              "value": 1264.2966
            }
          }
        }
      ],
      "productSpecification": {
        "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
        "name": "SD-WAN Service Package",
        "internalVersion": "3"
      },
      "prodSpecCharValueUse": [
        {
          "name": "Bandwidth",
          "description": "Bandwidth",
          "valueType": "choice",
          "validFor": {
            "startDatetime": "2026-12-06 02:32:11"
          },
          "productSpecCharacteristicValue": [
            {
              "value": "1 Gbps",
              "validFor": {
                "startDateTime": ""
              }
            },
            {
              "value": "5 Gbps",
              "validFor": {
                "startDateTime": ""
              }
            },
            {
              "value": "2 Gbps",
              "validFor": {
                "startDateTime": ""
              }
            },
            {
              "value": "500 Mbps",
              "validFor": {
                "startDateTime": ""
              }
            }
          ],
          "productSpecification": {
            "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
            "name": "SD-WAN Service Package",
            "internalVersion": "3"
          }
        }
      ],
      "channel": [
        {
          "id": "e561aae4c3e710105252716b7d40dd8f",
          "name": "Web"
        }
      ],
      "category": [
        {
          "id": "13e305a143b631105029d1529ab8f267",
          "name": "SD-WAN_all_offers"
        }
      ]
    }'

応答本文：

    {
      "result": {
        "name": "Offering 1",
        "displayName": "Offering 1",
        "description": "Offering 1 desc",
        "lastUpdate": "2024-04-01 16:05:19",
        "version": "Offering 1 EXTV",
        "validFor": {
          "startDateTime": "2028-02-29",
          "endDateTime": "2033-03-30"
        },
        "productOfferingTerm": "12_months",
        "productOfferingPrice": [
          {
            "priceType": "recurring",
            "price": {
              "taxIncludedAmount": {
                "unit": "USD",
                "value": 632.1483
              }
            }
          },
          {
            "priceType": "nonRecurring",
            "price": {
              "taxIncludedAmount": {
                "unit": "USD",
                "value": 1264.2966
              }
            }
          }
        ],
        "productSpecification": {
          "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
          "name": "SD-WAN Service Package",
          "internalVersion": "3",
          "sys_id": "79fa17da775131108e191e599a5a997b",
          "version": "",
          "status": "published",
          "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
        },
        "prodSpecCharValueUse": [
          {
            "name": "Bandwidth",
            "description": "Bandwidth",
            "valueType": "choice",
            "validFor": {
              "startDatetime": "2026-12-06 02:32:11"
            },
            "productSpecCharacteristicValue": [
              {
                "value": "1 Gbps",
                "validFor": {
                  "startDateTime": ""
                }
              },
              {
                "value": "5 Gbps",
                "validFor": {
                  "startDateTime": ""
                }
              },
              {
                "value": "2 Gbps",
                "validFor": {
                  "startDateTime": ""
                }
              },
              {
                "value": "500 Mbps",
                "validFor": {
                  "startDateTime": ""
                }
              }
            ],
            "productSpecification": {
              "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
              "name": "SD-WAN Service Package",
              "internalVersion": "3",
              "version": "",
              "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
            }
          }
        ],
        "channel": [
          {
            "id": "e561aae4c3e710105252716b7d40dd8f",
            "name": "Web"
          }
        ],
        "category": [
          {
            "id": "13e305a143b631105029d1529ab8f267",
            "name": "SD-WAN_all_offers"
          }
        ],
        "href": "/api/sn_tmf_api/catalogmanagement/productOffering/d6f8d9995b020210235d85cced81c7eb"
      }
    }

## 製品カタログオープン API - PATCH /sn_tmf_api/catalogmanagement/productSpecification/{id} {#ariaid-title11}

指定された製品仕様を更新します。

### URL 形式

デフォルト URL: /api/sn_tmf_api/catalogmanagement/productSpecification/{id}

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

{#tmf_prod_order-PATCH-productSpec-id__entry__2}

| 名前 | 説明 |
|-|-|
| id | 更新する製品オファリングのSys_id。製品仕様\[sn_prd_pm_product_specification\]テーブルにあります。 データタイプ：文字列 |
[表 : 55. パスパラメーター]

{#tmf_prod_order-PATCH-productSpec-id__entry__6}

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

{#tmf_prod_order-PATCH-productSpec-id__entry__10}

| 名前 | 説明 |
|-|-|
| description | 必須です。仕様の説明。 データタイプ：文字列 |
| externalId | 必須。製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の external_id。 データタイプ：文字列 |
| id | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の initial_version または external_id。 データタイプ：文字列 |
| internalId | 必須。製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の initial_version。 データタイプ：文字列 |
| internalVersion | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様のバージョン。 データタイプ：文字列 |
| isBundle | productSpecificationが単一の製品を表すか、製品のバンドルを表すかを示すフラグ。 有効な値： * true:製品仕様は製品バンドルであり、複数の製品が含まれています。 * false:製品仕様には単一の製品が含まれています。 {#tmf_prod_order-PATCH-productSpec-id__ul_rry_rz4_4bc} データタイプ：ブーリアン デフォルト値：false |
| lastUpdate | 仕様が最後に更新された日付。 データタイプ：文字列 デフォルト：空白の文字列 |
| name | 必須です。仕様の名前。 データタイプ：文字列 |
| productSpecCharacteristic | 仕様特性。 データタイプ：オブジェクトのアレイ "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] |
| productSpecCharacteristic.description | 特性の説明。 データタイプ：文字列 |
| productSpecCharacteristic.name | 必須です。特性の名前。 データタイプ：文字列 |
| prodSpecCharValueUse.productSpecCharacteristicValue | 特性の可能な値を含むアレイ。 データタイプ:オブジェクトのアレイ "productSpecCharacteristicValue": [ { "validFor": { "startDateTime": "String" }, "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | 特性の値。 データタイプ：文字列 |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor | 特性が有効になる日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor.startDateTime | 特性が有効になる開始日時。 形式:YYYY-MM-DD 00:00:00 データタイプ：文字列 |
| productSpecCharacteristic.validFor | 特性が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| productSpecCharacteristic.validFor.endDateTime | 特性の終了日時。 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 |
| productSpecCharacteristic.validFor.startDateTime | 特性の開始日時 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 |
| productSpecCharacteristic.valueType | 特性の値タイプ (選択肢やメールなど)。 データタイプ：文字列 |
| productSpecificationRelationship | この仕様と他の製品仕様との関係。 データタイプ：オブジェクトのアレイ "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ] |
| productSpecificationRelationship.id | 関連仕様の id。 データタイプ：文字列 |
| productSpecificationRelationship.type | productSpecificationRelationship パラメーターを使用する場合は必須です。関係のタイプ。 有効な値： * bundles * composed_of {#tmf_prod_order-PATCH-productSpec-id__ul_kjr_xnx_fsb} データタイプ：文字列 |
| productSpecificationRelationship.validFor | 関係が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| productSpecificationRelationship.validFor.endDateTime | 関係の終了日。 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 |
| productSpecificationRelationship.validFor.startDateTime | 関係の開始日。 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 |
| resourceSpecification | 必須です。この製品仕様に関連するリソース仕様のアレイ。 データタイプ：オブジェクトのアレイ "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| resourceSpecification.id | 必須です。リソース仕様の initial_version または external_id。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの sys_id または external_id フィールドにあります。 データタイプ：文字列 |
| resourceSpecification.internalId | リソース仕様の initial_version。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.internalVersion | リソース仕様のバージョン。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.name | リソース仕様の名前。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.version | リソース仕様の external_version。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification | この製品仕様に関連するサービス仕様のリスト。 データタイプ：オブジェクトのアレイ "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| serviceSpecification.id | サービス仕様の initial_version または external_id。サービス仕様 \[sn_prd_pm_service_specification\] テーブルの sys_id または external_id フィールドにあります。 データタイプ：文字列 |
| serviceSpecification.internalId | サービス仕様の initial_version。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.internalVersion | サービス仕様のバージョン。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.name | サービス仕様の名前。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.version | サービス仕様の external_version。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| validFor | 必須です。仕様が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| validFor.endDateTime | 仕様の終了日時。 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 |
| validFor.startDateTime | 仕様の開始日時。 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 |
| version | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の external_version。 データタイプ：文字列 |
[表 : 57. 要求本文パラメーター (JSON)]

### ヘッダー {#tmf_prod_order-PATCH-productSpec-id__section_rbn_cdj_4bc}

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

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

{#tmf_prod_order-PATCH-productSpec-id__table_kqy_wgy_fsb} {#tmf_prod_order-PATCH-productSpec-id__table_tzy_thy_ksb__entry__2}

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

{#tmf_prod_order-PATCH-productSpec-id__table_tzy_thy_ksb}

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 要求が正常に処理されました。 |
| 400 | 要求が正しくありません。考えられる理由： * 空のペイロード。 * 無効なペイロード必須フィールドがありません：\<フィールド名\> {#tmf_prod_order-PATCH-productSpec-id__ul_rys_1gy_fsb} |
| 404 | 見つかりません。要求アイテムが見つかりませんでした。 |
[表 : 60. ステータスコード]

{#tmf_prod_order-PATCH-productSpec-id__table_nxj_ykz_gsb}

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

{#tmf_prod_order-PATCH-productSpec-id__table_xj1_jcj_4bc__entry__2}

| 名前 | 説明 |
|-|-|
| description | 仕様の説明。 データタイプ：文字列 |
| href | リソースレコードへの相対リンク。 データタイプ：文字列 |
| id | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の initial_version または external_id。 データタイプ：文字列 |
| internalId | 必須。製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の initial_version。 データタイプ：文字列 |
| internalVersion | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様のバージョン。 データタイプ：文字列 |
| lastUpdate | 仕様が最後に更新された日付。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| name | 仕様の名前。 データタイプ：文字列 |
| productSpecCharacteristic | 仕様の特性。 データタイプ：オブジェクトのアレイ "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": Array, "validFor": Object, "valueType": "String" } ] |
| productSpecCharacteristic.description | 特性の説明。 データタイプ：文字列 |
| productSpecCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| prodSpecCharValueUse.productSpecCharacteristicValue | 特性の可能な値を含むアレイ。 データタイプ:オブジェクトのアレイ "productSpecCharacteristicValue": [ { "validFor": { "startDateTime": "String" }, "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | 特性の値。 データタイプ：文字列 |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor | 特性が有効になる日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor.startDateTime | 特性が有効になる開始日時。 形式:YYYY-MM-DD 00:00:00 データタイプ：文字列 |
| productSpecCharacteristic.validFor | 特性が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| productSpecCharacteristic.validFor.endDateTime | 特性の終了日時。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| productSpecCharacteristic.validFor.startDateTime | 特性の開始日時 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| productSpecCharacteristic.valueType | 特性の値タイプ (選択肢やメールなど)。 データタイプ：文字列 |
| productSpecificationRelationship | この仕様と他の製品仕様との関係。 データタイプ：オブジェクトのアレイ "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ] |
| productSpecificationRelationship.id | 関連仕様のSys_id。 データタイプ：文字列 |
| productSpecificationRelationship.type | 関係のタイプ。 データタイプ：文字列 |
| productSpecificationRelationship.validFor | 関係が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| productSpecificationRelationship.validFor.endDateTime | 関係の終了日とタイプ。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| productSpecificationRelationship.validFor.startDateTime | 関係の開始日とタイプ。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| resourceSpecification | この製品仕様に関連するリソース仕様のリスト。 データタイプ：オブジェクトのアレイ "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| resourceSpecification.id | リソース仕様の initial_version または external_id。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの sys_id または external_id フィールドにあります。 データタイプ：文字列 |
| resourceSpecification.internalId | リソース仕様の initial_version。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.internalVersion | リソース仕様のバージョン。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.name | リソース仕様の名前。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.version | リソース仕様の external_version。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification | この製品仕様に関連するサービス仕様のリスト。 データタイプ：オブジェクトのアレイ "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| serviceSpecification.id | サービス仕様の initial_version または external_id。サービス仕様 \[sn_prd_pm_service_specification\] テーブルの sys_id または external_id フィールドにあります。 データタイプ：文字列 |
| serviceSpecification.internalId | サービス仕様の initial_version。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.internalVersion | サービス仕様のバージョン。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.name | サービス仕様の名前。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.version | サービス仕様の external_version。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| validFor | 仕様が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| validFor.endDateTime | 仕様の終了日時。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| validFor.startDateTime | 仕様の開始日時。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| version | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の external_version。 データタイプ：文字列 |
[ ]

{#tmf_prod_order-PATCH-productSpec-id__table_xj1_jcj_4bc}  

### cURL 要求

次の例では、製品仕様 ID d6f8d9995b020210235d85cced81c7eb を、要求本文で指定された情報で更新します。

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productSpecification/d6f8d9995b020210235d85cced81c7eb" \ 
    --request PATCH\ 
    --header "Accept:application/json" \ 
    --user 'username':'password'
    --data '{
      "id": "1001",
      "name": "SD-WAN 0322 test",
      "description": "This is my product specification ...",
      "validFor": {
        "startDateTime": "2017-06-19T00:00",
        "endDateTime": "2018-01-13T00:00"
      },
      "productSpecCharacteristic": [
        {
          "name": "New characteristic",
          "description": "This product has new spec characteristic.",
          "valueType": "label",
          "validFor": {
            "startDateTime": "2017-06-20T00:00"
          }
        }
      ],
      "serviceSpecification": [
        {
          "id": "e23ae2d01bb420106ba59acf034bcb56",
          "name": "IP Sec Tunnel",
          "internalVersion": "2"
        }
      ],
      "productSpecificationRelationship": [
        {
          "id": "a6514bd3534560102f18ddeeff7b1247",
          "name": "SD-WAN Security",
          "internalVersion": "2",
          "type": "bundles",
          "validFor": {
            "startDateTime": "2017-06-16T00:00"
          }
        }
      ],
      "resourceSpecification": [
        {
          "id": "493fa60b536520103b6bddeeff7b12b6",
          "name": "Customer Premise SD-WAN Router"
        }
      ],
      "@type": "ProductSpecification"
    }

応答本文：

    {
      "result": {
        "id": "1001",
        "name": "SD-WAN 0322 test",
        "description": "This is my product specification ...",
        "validFor": {
          "startDateTime": "2017-06-19T00:00",
          "endDateTime": "2018-01-13T00:00"
        },
        "productSpecCharacteristic": [
          {
            "name": "New characteristic",
            "description": "This product has new spec characteristic.",
            "valueType": "label",
            "validFor": {
              "startDateTime": "2017-06-20T00:00"
            }
          }
        ],
        "serviceSpecification": [
          {
            "id": "e23ae2d01bb420106ba59acf034bcb56",
            "name": "IP Sec Tunnel",
            "internalVersion": "2",
            "sys_id": "dd8354205b550210235d85cced81c7cd",
            "version": "",
            "status": "published",
            "internalId": "e23ae2d01bb420106ba59acf034bcb56"
          }
        ],
        "productSpecificationRelationship": [
          {
            "id": "a6514bd3534560102f18ddeeff7b1247",
            "name": "SD-WAN Security",
            "internalVersion": "2",
            "type": "bundles",
            "validFor": {
              "startDateTime": "2017-06-16T00:00"
            },
            "sys_id": "7a491dd3776301108b2a1e599a5a99d3",
            "version": "",
            "status": "published",
            "internalId": "a6514bd3534560102f18ddeeff7b1247"
          }
        ],
        "resourceSpecification": [
          {
            "id": "493fa60b536520103b6bddeeff7b12b6",
            "name": "Customer Premise SD-WAN Router",
            "sys_id": "493fa60b536520103b6bddeeff7b12b6",
            "internalVersion": "1",
            "version": "",
            "status": "published",
            "internalId": "493fa60b536520103b6bddeeff7b12b6"
          }
        ],
        "@type": "ProductSpecification",
        "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/3d140fe85be1c210235d85cced81c73a"
      }
    }

## 製品カタログオープン API - POST /sn_tmf_api/catalogmanagement/catalog {#ariaid-title12}

製品オファリングカタログを作成します。

### URL 形式

デフォルト URL: /api/sn_tmf_api/catalogmanagement/catalog

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

{#tmf_prod_cat-POST-catalog__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 61. パスパラメーター]

{#tmf_prod_cat-POST-catalog__entry__6}

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

{#tmf_prod_cat-POST-catalog__entry__10}

| 名前 | 説明 |
|-|-|
| description | 製品オファリングカタログの説明。 データタイプ：文字列 デフォルト：空白の文字列 |
| externalId | 外部システムからの製品オファリングカタログの一意の識別子。 データタイプ：文字列 デフォルト：空白の文字列 |
| name | 必須です。製品オファリングカタログの名前。 データタイプ：文字列 |
[表 : 63. 要求本文パラメーター (JSON)]

### ヘッダー

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

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

{#tmf_prod_cat-POST-catalog__table_ett_h3z_gsb} {#tmf_prod_cat-POST-catalog__table_tzy_thy_ksb__entry__2}

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

{#tmf_prod_cat-POST-catalog__table_tzy_thy_ksb}

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 201 | 要求が正常に処理されました。 |
| 400 | 要求が正しくありません。以下のいずれかの理由が考えられます。 * 空のペイロード。 * 無効なペイロード必須フィールドがありません：\<フィールド名\> {#tmf_prod_cat-POST-catalog__ul_nc5_myx_fsb} |
[表 : 66. ステータスコード]

{#tmf_prod_cat-POST-catalog__table_fbw_k3z_gsb}

### 応答本文のパラメーター (JSON)

{#tmf_prod_cat-POST-catalog__entry__34}

| 名前 | 説明 |
|-|-|
| description | 製品オファリングカタログの説明。 データタイプ：文字列 |
| id | 製品オファリングカタログ \[sn_prd_pm_product_offering_catalog\] テーブルの製品オファリングカタログの sys_id。 データタイプ：文字列 |
| name | 製品オファリングカタログの名前。 データタイプ：文字列 |
[ ]

### cURL 要求

この例では、製品オファリングカタログを作成します。

    curl --location --request POST "https://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/catalog" \
    --header "Content-Type: application/json" \
    --data-raw '{
        "id": "testId",
        "name": "Catalog",
        "description": "Description"
    }'
    --user 'username':'password'

応答本文。

    {
       "id": "45715d02c3510110bc0526083c40dd6b",
       "description": "Description",
       "name": "Catalog1"
    }

## 製品カタログオープン API - POST /sn_tmf_api/catalogmanagement/productOffering {#ariaid-title13}

製品オファリングを作成します。

### URL 形式

デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOffering

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

{#tmf_prod_cat-POST-prodoffering__table_o3n_mvf_hsb__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 67. パスパラメーター]

{#tmf_prod_cat-POST-prodoffering__table_o3n_mvf_hsb} {#tmf_prod_cat-POST-prodoffering__entry__6}

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

{#tmf_prod_cat-POST-prodoffering__table_vxh_xvf_hsb__entry__2}

| 名前 | 説明 |
|-|-|
| category | 製品が属するカテゴリのリスト。カテゴリ \[sc_category\] テーブルにあります。 データタイプ：オブジェクトのアレイ "category:" [ { "id": "String", "name": "String" } ] |
| category.id | category パラメーターを使用する場合は必須です。カテゴリの ID。 データタイプ：文字列 |
| category.name | カテゴリの名前。 データタイプ：文字列 |
| チャネル | 必須です。製品オファリングの販売に使用するチャネル。 データタイプ：アレイ "channel:" [ { "description": "String", "id": "String", "name": "String" } ] |
| channel.description | チャネルの説明。 データタイプ：文字列 |
| channel.id | 必須です。流通チャネル \[sn_prd_pm_distribution_channel\] テーブルのチャネルの sys_id。 データタイプ：文字列 |
| channel.name | チャネルの名前。 データタイプ：文字列 |
| 説明 | 必須です。製品オファリングの説明。 データタイプ：文字列 |
| externalId | 外部システムからの製品オファリングの一意の識別子。 データタイプ：文字列 |
| href | リソースレコードへの相対リンク。 データタイプ：文字列 |
| id | 必須です。製品オファリング \[sn_prd_pm_product_offering\] テーブルの製品オファリングの initial_version または external_id。 データタイプ：文字列 |
| internalId | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのinitial_version。 データタイプ：文字列 |
| internalVersion | 製品オファリング \[sn_prd_pm_product_offering\] テーブルの製品オファリングのバージョン。 データタイプ：文字列 |
| lastUpdate | 製品オファリングが最後に更新された日付。 データタイプ：文字列 |
| ライフサイクルステータス | 現在のライフサイクルステータスを示します。受け入れ可能な値: * アクティブ * 非アクティブ * ドラフト {#tmf_prod_cat-POST-prodoffering__ul_lj5_gg4_4bc} データタイプ：文字列 |
| name | 必須です。製品オファリングの名前。 データタイプ：文字列 |
| productCharacteristic | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 |
| productOfferingPrice | 製品オファリングの価格情報。 データタイプ：オブジェクトのアレイ "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] |
| productOfferingPrice.price | 製品オファリングの価格情報。 データタイプ：オブジェクト "price": { "taxIncludedAmount": {Object} } |
| productOfferingPrice.price.taxIncludedAmount | 製品オファリングの価格情報。 データタイプ：オブジェクト "taxIncludedAmount": { "unit": "String", "value": "String" } |
| productOfferingPrice.price.taxIncludedAmount.unit | 製品オファリング価格の通貨コード。 データタイプ：文字列 |
| productOfferingPrice.price.taxIncludedAmount.value | 税込みの製品オファリングの価格。 データタイプ：文字列 |
| productOfferingPrice.priceType | productOfferingPrice パラメーターを使用する場合は必須です。製品オファリング価格タイプ (1 回払いまたは繰り返し支払い)。 有効な値： * nonRecurring (1 回) * recurring データタイプ：文字列 |
| productOfferingTerm | 製品オファリングの有効な契約期間。 データタイプ：文字列 |
| productSpecification | 必須です。製品の製品仕様。 データタイプ：オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | 必須です。製品仕様の initial_version または external_id。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.internalId | 製品仕様のinitial_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.internalVersion | 製品仕様のバージョン。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.version | 製品仕様のexternal_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| prodSpecCharValueUse | 製品オファリング特性。 データタイプ：オブジェクトのアレイ "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": Array, "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue | 必須です。特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | 必須です。特性の値。 データタイプ：文字列 |
| prodSpecCharValueUse.description | 特性の説明。 データタイプ：文字列 |
| prodSpecCharValueUse.name | 必須です。特性の名前。 データタイプ：文字列 |
| prodSpecCharValueUse.validFor | 特性が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| prodSpecCharValueUse.validFor.endDateTime | 特性の終了日。 データタイプ：文字列 |
| prodSpecCharValueUse.validFor.startDateTime | 特性の開始日。 データタイプ：文字列 |
| prodSpecCharValueUse.valueType | 特性の値タイプ (選択肢やメールなど)。 データタイプ：文字列 |
| validFor | 必須です。製品オファリングが有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| validFor.endDateTime | 製品オファリングの終了日。 データタイプ：文字列 |
| validFor.startDateTime | 製品オファリングの開始日。 データタイプ：文字列 |
| version | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのexternal_version。 データタイプ：文字列 |
[表 : 69. 要求本文パラメーター (JSON)]

{#tmf_prod_cat-POST-prodoffering__table_vxh_xvf_hsb}

### ヘッダー

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

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

{#tmf_prod_cat-POST-prodoffering__table_ett_h3z_gsb} {#tmf_prod_cat-POST-prodoffering__table_tzy_thy_ksb__entry__2}

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

{#tmf_prod_cat-POST-prodoffering__table_tzy_thy_ksb}

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 201 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。考えられる理由： * 空のペイロード。 * 無効なペイロード必須フィールドがありません：\<フィールド名\> {#tmf_prod_cat-POST-prodoffering__ul_nc5_myx_fsb} |
[表 : 72. ステータスコード]

{#tmf_prod_cat-POST-prodoffering__table_fbw_k3z_gsb}

### 応答本文のパラメーター (JSON)

{#tmf_prod_cat-POST-prodoffering__entry__116}

| 名前 | 説明 |
|-|-|
| category | 製品が属するカテゴリのリスト。 データタイプ：アレイ "category:" [ { "id": "String", "name": "String" } ] |
| category.id | カテゴリの ID。 データタイプ：文字列 |
| category.name | カテゴリの名前。 データタイプ：文字列 |
| channel | 製品オファリングの販売に使用するチャネル。 データタイプ：オブジェクトのアレイ "channel:" [ { "description": "String", "id": "String", "name": "String" } ] |
| channel.description | チャネルの説明。 データタイプ：文字列 |
| channel.id | 流通チャネル \[sn_prd_pm_distribution_channel\] テーブルのチャネルの sys_id。 データタイプ：文字列 |
| channel.name | チャネルの名前。 データタイプ：文字列 |
| description | 製品オファリングの説明。 データタイプ：文字列 |
| externalId | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのexternal_id。 データタイプ：文字列 |
| href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 |
| id | 必須。製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのinitial_versionまたはexternal_id。 データタイプ：文字列 |
| internalId | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのinitial_version。 データタイプ：文字列 |
| internalVersion | 製品オファリング \[sn_prd_pm_product_offering\] テーブルの製品オファリングのバージョン。 データタイプ：文字列 |
| lastUpdate | 製品オファリングが最後に更新された日付。 データタイプ：文字列 |
| ライフサイクルステータス | 製品オファリングの現在のライフサイクルステータス。 受け入れ可能な値: * アクティブ * 非アクティブ * ドラフト {#tmf_prod_cat-POST-prodoffering__ul_vrb_d35_dcc} データタイプ：文字列 デフォルト：空白の文字列 |
| name | 製品オファリングの名前。 データタイプ：文字列 |
| productCharacteristic | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 |
| productOfferingPrice | 製品オファリングの価格情報。 データタイプ：オブジェクトのアレイ "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] |
| productOfferingPrice.price | 製品オファリングの価格情報。 データタイプ：オブジェクト "price": { "taxIncludedAmount": {Object} } |
| productOfferingPrice.price.taxIncludedAmount | 製品オファリングの価格情報。 データタイプ：オブジェクト "taxIncludedAmount": { "unit": "String", "value": "String" } |
| productOfferingPrice.price.taxIncludedAmount.unit | 製品オファリング価格の通貨コード。 データタイプ：文字列 |
| productOfferingPrice.price.taxIncludedAmount.value | 税込みの製品オファリングの価格。 データタイプ：文字列 |
| productOfferingPrice.priceType | 製品オファリング価格タイプ (1 回払いまたは繰り返し支払い)。 可能な値： * nonRecurring (1 回) * recurring データタイプ：文字列 |
| productOfferingTerm | 製品オファリングの有効な契約期間。 データタイプ：文字列 |
| productSpecification | 製品の製品仕様。 データタイプ：オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | 製品仕様のinitial_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.internalId | 製品仕様のinitial_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.internalVersion | 製品仕様のバージョン。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| productSpecification.version | 製品仕様のexternal_version。製品仕様 \[sn_prd_pm_product_specification\] テーブルにあります。 データタイプ：文字列 |
| prodSpecCharValueUse | 製品オファリング特性。 データタイプ：オブジェクトのアレイ "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": Array, "description": "String", "name": "String", "validFor": Object, "valueType": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | 特性の値。 データタイプ：文字列 |
| prodSpecCharValueUse.description | 特性の説明。 データタイプ：文字列 |
| prodSpecCharValueUse.name | 特性の名前。 データタイプ：文字列 |
| prodSpecCharValueUse.validFor | 特性が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| prodSpecCharValueUse.validFor.endDateTime | 特性の終了日。 データタイプ：文字列 |
| prodSpecCharValueUse.validFor.startDateTime | 特性の開始日。 データタイプ：文字列 |
| prodSpecCharValueUse.valueType | 特性の値タイプ (選択肢やメールなど)。 データタイプ：文字列 |
| validFor | 製品オファリングが有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| validFor.endDateTime | 製品オファリングの終了日。 データタイプ：文字列 |
| validFor.startDateTime | 製品オファリングの開始日。 データタイプ：文字列 |
| version | 製品オファリング \[sn_prd_pm_product_offering\] テーブルからの製品オファリングのexternal_version。 データタイプ：文字列 |
[ ]

### cURL 要求

この例では、製品オファリングを作成します。

    curl --location --request POST "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productOffering" \
    --header "Content-Type: application/json" \
    --data-raw '{
       "id": "d52a756b5bde0110235d85cced81c7ab",
       "name": "Premium SD-WAN Offering New",
       "version": "",
       "internalVersion": "2",
       "description": "Premium SD-WAN Offering",
       "lastUpdate": "2021-08-16 04:55:52",
       "validFor": {
          "startDateTime": "2021-08-05",
          "endDateTime": "2026-09-04"
       },
       "productOfferingTerm": "24_months",
       "productOfferingPrice": [
          {
             "priceType": "recurring",
             "price": {
                "taxIncludedAmount": {
                   "unit": "JPY",
                   "value": 984.0913488140197
                }
             }
          },
          {
             "priceType": "nonRecurring",
             "price": {
                "taxIncludedAmount": {
                   "unit": "GBP",
                   "value": 2434
                }
             }
          }
       ],
       "productSpecification": {
          "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
          "name": "SD-WAN Service Package",
          "version": "v1",
          "internalVersion": "1",
          "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
       },
       "prodSpecCharValueUse": [
          {
             "name": "Tenancy",
             "description": "Tenancy",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:04:24"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Premium (>50 sites)",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance (50 site)",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base (10 site)",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "216663aa53702010cd6dddeeff7b12b5",
                "name": "SD-WAN Controller",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "216663aa53702010cd6dddeeff7b12b5"
             }
          },
          {
             "name": "CPE Id",
             "description": "CPE Id",
             "valueType": "single_line_text",
             "validFor": {
                "startDatetime": "2021-08-15 17:50:26"
             },
             "productSpecCharacteristicValue": [],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "Routing",
             "description": "Routing",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:08:20"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "WAN Optimization",
             "description": "WAN Optimization",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:10:28"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "CPE Model",
             "description": "CPE Model",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:11:54"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "ISR",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "ASR",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "Security Type",
             "description": "Security Type",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-23 12:51:13"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "a6514bd3534560102f18ddeeff7b1247",
                "name": "SD-WAN Security",
                "version": "v1",
                "internalVersion": "1",
                "internalId": " a6514bd3534560102f18ddeeff7b1247"
             }
          },
          {
             "name": "CPE Type",
             "description": "CPE Type",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:11:16"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Physical",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Virtual",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v1",
                "internalVersion": "1",
                "internalId": " 39b627aa53702010cd6dddeeff7b1202"
             }
          }
       ],
       "channel": [
          {
             "id": "e561aae4c3e710105252716b7d40dd8f",
             "name": "Web"
          }
       ],
       "category": {
          "id": "c0ed043653b02010cd6dddeeff7b1277",
          "name": "SD-WAN"
       }
    }'
    --user 'username':'password'

応答本文：

    {
       "id": "d52a756b5bde0110235d85cced81c7ab",
       "name": "Premium SD-WAN Offering New",
       "version": null,
       "internalVersion": "5",
       "description": "Premium SD-WAN Offering",
       "lastUpdate": "2021-08-16 04:55:52",
       "validFor": {
          "startDateTime": "2021-08-05",
          "endDateTime": "2026-09-04"
       },
       "productOfferingTerm": "24_months",
       "productOfferingPrice": [
          {
             "priceType": "recurring",
             "price": {
                "taxIncludedAmount": {
                   "unit": "JPY",
                   "value": 984.0913488140197
                }
             }
          },
          {
             "priceType": "nonRecurring",
             "price": {
                "taxIncludedAmount": {
                   "unit": "GBP",
                   "value": 2434
                }
             }
          }
       ],
       "productSpecification": {
          "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
          "name": "SD-WAN Service Package",
          "version": null,
          "internalVersion": "1",
          "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
       },
       "prodSpecCharValueUse": [
          {
             "name": "Tenancy",
             "description": "Tenancy",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:04:24"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Premium (>50 sites)",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance (50 site)",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base (10 site)",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "216663aa53702010cd6dddeeff7b12b5",
                "name": "SD-WAN Controller",
                "version": null,
                "internalVersion": "1",
                "internalId": "216663aa53702010cd6dddeeff7b12b5"
             }
          },
          {
             "name": "CPE Id",
             "description": "CPE Id",
             "valueType": "single_line_text",
             "validFor": {
                "startDatetime": "2021-08-15 17:50:26"
             },
             "productSpecCharacteristicValue": [],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": null,
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "Routing",
             "description": "Routing",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:08:20"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": null,
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "WAN Optimization",
             "description": "WAN Optimization",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:10:28"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": null,
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "CPE Model",
             "description": "CPE Model",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:11:54"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "ISR",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "ASR",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": null,
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "Security Type",
             "description": "Security Type",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-23 12:51:13"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "a6514bd3534560102f18ddeeff7b1247",
                "name": "SD-WAN Security",
                "version": null,
                "internalVersion": "1",
                "internalId": "a6514bd3534560102f18ddeeff7b1247"
             }
          },
          {
             "name": "CPE Type",
             "description": "CPE Type",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:11:16"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Physical",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Virtual",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": null,
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          }
       ],
       "channel": [
          {
             "id": "e561aae4c3e710105252716b7d40dd8f",
             "name": "Web"
          }
       ],
       "category": {
          "id": "c0ed043653b02010cd6dddeeff7b1277",
          "name": "SD-WAN"
       },
       "internalId": "fbc1c0a25b030110235d85cced81c724",
       "externalId": "d52a756b5bde0110235d85cced81c7ab"
    }

## 製品カタログオープン API - POST /sn_tmf_api/catalogmanagement/productSpecification {#ariaid-title14}

製品仕様を作成します。

### URL 形式

デフォルト URL: /api/sn_tmf_api/catalogmanagement/productSpecification

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

{#tmf_prod_cat-POST-prodspec__table_jdq_g51_jsb__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 73. パスパラメーター]

{#tmf_prod_cat-POST-prodspec__table_jdq_g51_jsb} {#tmf_prod_cat-POST-prodspec__entry__6}

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

{#tmf_prod_cat-POST-prodspec__table_db1_q51_jsb__entry__2}

| 名前 | 説明 |
|-|-|
| description | 必須です。仕様の説明。 データタイプ：文字列 |
| externalId | 外部システムからの製品仕様の一意の識別子。 データタイプ：文字列 デフォルト：空白の文字列 |
| id | 必須です。製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の initial_version または external_id。 データタイプ：文字列 |
| internalId | 必須。製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の initial_version。 データタイプ：文字列 |
| internalVersion | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様のバージョン。 データタイプ：文字列 |
| lastUpdate | 仕様が最後に更新された日付。 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 デフォルト：空白の文字列 |
| name | 必須です。仕様の名前。 データタイプ：文字列 |
| productSpecCharacteristic | 仕様特性。 データタイプ：アレイ "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": Array, "validFor": Object, "valueType": "String" } ] |
| productSpecCharacteristic.description | 特性の説明。 データタイプ：文字列 デフォルト：空白の文字列 |
| productSpecCharacteristic.name | 必須です。特性の名前。 データタイプ：文字列 |
| productSpecCharacteristic.productSpecCharacteristicValue | 必須です。特性の可能な値を含むアレイ。 データタイプ：アレイ "productSpecCharacteristicValue": [ { "value": "String" } ] |
| productSpecCharacteristic.productSpecCharacteristicValue.value | 必須です。特性の値。 データタイプ：文字列 |
| productSpecCharacteristic.validFor | 特性が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| productSpecCharacteristic.validFor.endDateTime | 特性の終了日。 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 デフォルト：空白の文字列 |
| productSpecCharacteristic.validFor.startDateTime | 特性の開始日。 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 デフォルト：空白の文字列 |
| productSpecCharacteristic.valueType | 特性の値タイプ (選択肢やメールなど)。 データタイプ：文字列 デフォルト：空白の文字列 |
| productSpecificationRelationship | この仕様と他の製品仕様との関係。 データタイプ：アレイ "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ] |
| productSpecificationRelationship.id | 関連仕様の ID。 データタイプ：文字列 デフォルト：空白の文字列 |
| productSpecificationRelationship.type | productSpecificationRelationship パラメーターを使用する場合は必須です。関係のタイプ。 有効な値： * composed_of * bundles {#tmf_prod_cat-POST-prodspec__ul_kjr_xnx_fsb} データタイプ：文字列 |
| productSpecificationRelationship.validFor | 関係が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| productSpecificationRelationship.validFor.endDateTime | 関係の終了日。 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 デフォルト：空白の文字列 |
| productSpecificationRelationship.validFor.startDateTime | 関係の開始日。 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 デフォルト：空白の文字列 |
| resourceSpecification | 必須です。この製品仕様に関連するリソース仕様のアレイ。 データタイプ：アレイ "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| resourceSpecification.id | 必須。リソース仕様のinitial_versionまたはexternal_id。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの sys_id または external_id フィールドにあります。 データタイプ：文字列 |
| resourceSpecification.internalId | リソース仕様の initial_version。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.internalVersion | リソース仕様のバージョン。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.name | リソース仕様の名前。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.version | リソース仕様の external_version。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification | この製品仕様に関連するサービス仕様のリスト。 データタイプ：オブジェクトのアレイ "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| serviceSpecification.id | サービス仕様の initial_version または external_id。サービス仕様 \[sn_prd_pm_service_specification\] テーブルの sys_id または external_id フィールドにあります。 データタイプ：文字列 |
| serviceSpecification.internalId | サービス仕様の initial_version。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.internalVersion | サービス仕様のバージョン。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.name | サービス仕様の名前。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.version | サービス仕様の external_version。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| validFor | 必須です。仕様が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| validFor.endDateTime | 仕様の終了日。 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 デフォルト：空白の文字列 |
| validFor.startDateTime | 仕様の開始日。 形式:YYYY-MM-DD 00:00:00。`たとえば、2025-01-31 09:35:43` などです。 データタイプ：文字列 デフォルト：空白の文字列 |
| version | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の external_version。 データタイプ：文字列 |
[表 : 75. 要求本文パラメーター (JSON)]

{#tmf_prod_cat-POST-prodspec__table_db1_q51_jsb}

### ヘッダー

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

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

{#tmf_prod_cat-POST-prodspec__table_ett_h3z_gsb} {#tmf_prod_cat-POST-prodspec__table_tzy_thy_ksb__entry__2}

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

{#tmf_prod_cat-POST-prodspec__table_tzy_thy_ksb}

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 201 | 要求が正常に処理されました。 |
| 400 | 要求が正しくありません。考えられる理由： * 空のペイロード。 * 無効なペイロード必須フィールドがありません：\<フィールド名\> {#tmf_prod_cat-POST-prodspec__ul_nc5_myx_fsb} |
[表 : 78. ステータスコード]

{#tmf_prod_cat-POST-prodspec__table_fbw_k3z_gsb}

### 応答本文のパラメーター (JSON)

{#tmf_prod_cat-POST-prodspec__entry__104}

| 名前 | 説明 |
|-|-|
| description | 仕様の説明。 データタイプ：文字列 |
| href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 |
| id | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の initial_version または external_id。 データタイプ：文字列 |
| internalId | 必須。製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の initial_version。 データタイプ：文字列 |
| internalVersion | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様のバージョン。 データタイプ：文字列 |
| isBundle | productSpecificationが単一の製品を表すか、製品のバンドルを表すかを示すフラグ。 有効な値： * true:製品仕様は製品バンドルであり、複数の製品が含まれています。 * false:製品仕様には単一の製品が含まれています。 {#tmf_prod_cat-POST-prodspec__ul_rry_rz4_4bc} データタイプ：ブーリアン デフォルト値：false |
| lastUpdate | 仕様が最後に更新された日付。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| ライフサイクルステータス | 製品仕様の現在のライフサイクルステータス。 可能な値： * アクティブ * 非アクティブ * ドラフト {#tmf_prod_cat-POST-prodspec__ul_lj5_gg4_4bc} データタイプ：文字列 デフォルト：空白の文字列 |
| name | 仕様の名前。 データタイプ：文字列 |
| productSpecCharacteristic | 仕様特性。 データタイプ：アレイ "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": Array, "validFor": Object, "valueType": "String" } ] |
| productSpecCharacteristic.description | 特性の説明。 データタイプ：文字列 |
| productSpecCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productSpecCharacteristic.productSpecCharacteristicValue | 特性の可能な値を含むアレイ。 データタイプ：アレイ "productSpecCharacteristicValue": [ { "value": "String" } ] |
| productSpecCharacteristic.productSpecCharacteristicValue.value | 特性の値。 データタイプ：文字列 |
| productSpecCharacteristic.validFor | 特性が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| productSpecCharacteristic.validFor.endDateTime | 特性の終了日。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| productSpecCharacteristic.validFor.startDateTime | 特性の開始日。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| productSpecCharacteristic.valueType | 特性の値タイプ (選択肢やメールなど)。 データタイプ：文字列 |
| productSpecificationRelationship | この仕様と他の製品仕様との関係。 データタイプ：アレイ "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ] |
| productSpecificationRelationship.id | 関連仕様のSys_id。 データタイプ：文字列 |
| productSpecificationRelationship.type | 関係のタイプ。 データタイプ：文字列 |
| productSpecificationRelationship.validFor | 関係が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| productSpecificationRelationship.validFor.endDateTime | 関係の終了日。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| productSpecificationRelationship.validFor.startDateTime | 関係の開始日。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| resourceSpecification | この製品仕様に関連するリソース仕様のリスト。 データタイプ：オブジェクトのアレイ "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| resourceSpecification.id | リソース仕様の initial_version または external_id。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの sys_id または external_id フィールドにあります。 データタイプ：文字列 |
| resourceSpecification.internalId | リソース仕様の initial_version。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.internalVersion | リソース仕様のバージョン。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.name | リソース仕様の名前。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| resourceSpecification.version | リソース仕様の external_version。リソース仕様 \[sn_prd_pm_resource_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification | この製品仕様に関連するサービス仕様のリスト。 データタイプ：オブジェクトのアレイ "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| serviceSpecification.id | サービス仕様の initial_version または external_id。サービス仕様 \[sn_prd_pm_service_specification\] テーブルの sys_id または external_id フィールドにあります。 データタイプ：文字列 |
| serviceSpecification.internalId | サービス仕様の initial_version。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.internalVersion | サービス仕様のバージョン。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.name | サービス仕様の名前。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| serviceSpecification.version | サービス仕様の external_version。サービス仕様 \[sn_prd_pm_service_specification\] テーブルにあります。 データタイプ：文字列 |
| validFor | 仕様が有効な日付範囲。 データタイプ：オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| validFor.endDateTime | 仕様の終了日。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| validFor.startDateTime | 仕様の開始日。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 |
| version | 製品仕様 \[sn_prd_pm_product_specification\] テーブルの製品仕様の external_version。 データタイプ：文字列 |
[ ]

### cURL 要求

この例では、製品仕様を作成します。

    curl --location --request POST "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification" \
    --header "Content-Type: application/json" \
    --data-raw '{
       "name": "SD-WAN My Device",
       "description": "This is my product specification ...",
       "internalId": "1c3c9a325bc34110235d85cced81c7d5",
       "isBundle": false,
       "lastUpdate": "2017-06-17T00:00",
       "validFor": {
          "startDateTime": "2017-06-19T00:00",
          "endDateTime": "2018-01-13T00:00"
       },
       "productSpecCharacteristic": [
          {
             "name": "New characteristic",
             "description": "This product has new spec characteristic.",
             "valueType": "label",
             "validFor": {
                "startDateTime": "2017-06-20T00:00"
             },
             "productSpecCharacteristicValue": [
                {
                   "validFor": {
                      "startDateTime": "2017-06-17T00:00"
                   },
                   "value": "TestValue"
                }
             ]
          }
       ],
       "serviceSpecification": [
          {
             "id": "e23ae2d01bb420106ba59acf034bcb56",
             "name": "IP Sec Tunnel"
          }
       ],
       "productSpecificationRelationship": [
          {
             "id": "a6514bd3534560102f18ddeeff7b1247",
             "name": "SD-WAN Security",
             "type": "bundles",
             "validFor": {
                "startDateTime": "2017-06-16T00:00"
             }
          }
       ],
       "resourceSpecification": [
          {
             "id": "493fa60b536520103b6bddeeff7b12b6",
             "name": "Customer Premise SD-WAN Router"
          }
       ]
    }'
    --user 'username':'password'

応答本文。

    {
       "id": "exter123",
       "name": "SD-WAN My Device",
       "version": "v1",
       "internalId": "63c3d946745d8150f877ca57242ff918",
       "description": "This is my product specification ...",
       "isBundle": false,
       "lastUpdate": "2017-06-17T00:00",
       "validFor": {
          "startDateTime": "2017-06-19T00:00",
          "endDateTime": "2018-01-13T00:00"
       },
       "productSpecCharacteristic": [
          {
             "name": "New characteristic",
             "description": "This product has new spec characteristic.",
             "valueType": "choice",
             "validFor": {
                "startDateTime": "2017-06-20T00:00"
             },
             "productSpecCharacteristicValue": [
                {
                   "validFor": {
                      "startDateTime": "2017-06-17T00:00"
                   },
                   "value": "TestValue"
                }
             ]
          }
       ],
       "serviceSpecification": [
          {
             "id": "e23ae2d01bb420106ba59acf034bcb56",
             "name": "IP Sec Tunnel",
             "version": "v1",
             "internalVersion": "1",
             "internalId": "e23ae2d01bb420106ba59acf034bcb56"
          }
       ],
       "productSpecificationRelationship": [
          {
             "id": "a6514bd3534560102f18ddeeff7b1247",
             "name": "SD-WAN Security",
             "type": "bundles",
             "validFor": {
                "startDateTime": "2017-06-16T00:00"
             },
             "valid": true,
             "version": "v1",
             "internalVersion": "1",
             "internalId": "a6514bd3534560102f18ddeeff7b1247"
          }
       ],
       "resourceSpecification": [
          {
             "id": "493fa60b536520103b6bddeeff7b12b6",
             "name": "Customer Premise SD-WAN Router",
             "version": "v1",
             "internalVersion": "1",
             "internalId": "493fa60b536520103b6bddeeff7b12b6"
          }
       ]
    }