--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # 製品カタログオープン API # 製品カタログオープン API {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：336分 製品カタログオープン API は、製品カタログ、製品オファリング、および製品仕様を作成および取得するためのエンドポイントを提供します。 この API を使用して、外部システムと ServiceNow AI Platformの間の製品カタログ情報を管理します。製品カタログオープン API は、TM フォーラムの製品カタログ管理 API REST 仕様のServiceNow®実装です。この実装は、 [TMF620 Product Catalog Management API User Guide v5.0.0](https://www.tmforum.org/resources/specifications/tmf620-product-catalog-management-api-user-guide-v5-0-0/) (2024 年 9 月) に基づいています。 この 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 - DELETE /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/lLW_uT5I5_l1aD8yR4Jt9A "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/lLW_uT5I5_l1aD8yR4Jt9A "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 - DELETE /sn_tmf_api/catalogmanagement/productOfferingPrice/{id} {#ariaid-title3} 特定のsys_idの価格明細を非アクティブ化しますが、削除はしません。 価格明細を非アクティブ状態に設定するには、この DELETE メソッドで価格明細の終了日を今日の日付に更新します。終了日が今日の日付より前の価格明細も非アクティブと見なされます。非アクティブな価格明細は、関連する GET メソッドでは取得できません。 ### URL 形式 デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice/{id} ### サポートされている要求パラメーター {#tmf_prod_order-DEL-prodoffprice-id__entry__2} | 名前 | 説明 | |-|-| | ID | 削除する価格明細のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | [表 : 7. パスパラメーター] {#tmf_prod_order-DEL-prodoffprice-id__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 8. クエリパラメーター] {#tmf_prod_order-DEL-prodoffprice-id__entry__10} | 名前 | 説明 | |-|-| | なし | | [表 : 9. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_order-DEL-prodoffprice-id__entry__14}{#tmf_prod_order-DEL-prodoffprice-id__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 10. 要求ヘッダー] {#tmf_prod_order-DEL-prodoffprice-id__entry__18} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 11. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#tmf_prod_order-DEL-prodoffprice-id__table_onp_pnw_22c__entry__2}{#tmf_prod_order-DEL-prodoffprice-id__entry-200-status-code}{#tmf_prod_order-DEL-prodoffprice-id__entry-404-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。 考えられる理由: * 無効なパスパラメーター * 無効な URI {#tmf_prod_order-DEL-prodoffprice-id__ul_qkg_2rv_22c} | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | [表 : 12. ステータスコード] {#tmf_prod_order-DEL-prodoffprice-id__table_onp_pnw_22c} ### 応答本文のパラメーター (JSON または XML) {#tmf_prod_order-DEL-prodoffprice-id__entry__30} | 名前 | 説明 | |-|-| | メッセージ | 価格明細の非アクティブ化の成功または失敗に関するメッセージを含むステータスコード。 | [ ] ### cURL 要求 次の例は、指定されたsys_id (994 日) の価格リストを正常に非アクティブ化または削除する方法を示しています。 curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOfferingPrice/994d5d364f8b5210f899f61d20ce0b7c" \ --request DELETE\ --user 'username':'password' 応答。応答は、正常な非アクティブ化の詳細を含む 200 ステータスコードを返します。 Status: 200 OK "The price list line (994d5d364f8b5210f899f61d20ce0b7c) is inactive successfully" ## 製品カタログオープン API - DELETE /sn_tmf_api/catalogmanagement/productSpecification/{id} {#ariaid-title4} 指定された製品仕様を削除またはアーカイブします。 この 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\] | [表 : 13. パスパラメーター] {#tmf_prod_cat-DELETE-prodSpec-id__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 14. クエリパラメーター] {#tmf_prod_cat-DELETE-prodSpec-id__entry__10} | 名前 | 説明 | |-|-| | なし | | [表 : 15. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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 | [表 : 16. 要求ヘッダー] {#tmf_prod_cat-DELETE-prodSpec-id__table_u3k_cgq_mbc} {#tmf_prod_cat-DELETE-prodSpec-id__entry__18} | ヘッダー | 説明 | |-|-| | なし | | [表 : 17. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | [表 : 18. ステータスコード] {#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-title5} すべての製品オファリングカタログのリストを取得します。 ### URL 形式 デフォルト URL: /api/sn_tmf_api/catalogmanagement/catalog ### サポートされている要求パラメーター {#tmf_prod_cat-GET-catalog__table_ofr_vgy_fsb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 19. パスパラメーター] {#tmf_prod_cat-GET-catalog__table_ofr_vgy_fsb} {#tmf_prod_cat-GET-catalog__table_c3q_ylz_gsb__entry__2} | 名前 | 説明 | |-|-| | フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 データタイプ：文字列 デフォルト:すべてのフィールドが返されます。 | | limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、 offset パラメーターを使用してレコード取得をページネーションします。 データタイプ：数値 デフォルト値：20 最大:100 | | オフセット | レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。 データタイプ：数値 デフォルト：0 | [表 : 20. クエリパラメーター] {#tmf_prod_cat-GET-catalog__table_c3q_ylz_gsb} {#tmf_prod_cat-GET-catalog__table_gld_vkz_gsb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 21. 要求本文パラメーター (JSON)] {#tmf_prod_cat-GET-catalog__table_gld_vkz_gsb} ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_cat-GET-catalog__table_kqy_wgy_fsb__entry__2}{#tmf_prod_cat-GET-catalog__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 22. 要求ヘッダー] {#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 ヘッダーの値は `アイテム 3 から 5` です。 | | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | | 「リンク」 | クエリ結果間を移動するための次のリンクが含まれています。 * 第 1 * 最終 * 次へ * 前へ {#tmf_prod_cat-GET-catalog__ul_zzk_sdm_lsb} | | X-合計-数 | ページネーションされたクエリの場合、このヘッダーはサーバーで使用可能なレコードの合計数を指定します。 | [表 : 23. 応答ヘッダー] {#tmf_prod_cat-GET-catalog__table_nww_xgm_lsb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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 | レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。 | [表 : 24. ステータスコード] {#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 | 製品オファリングカタログの説明。フィールドに値が含まれている場合にのみ返されます。 データタイプ：文字列 | | 外部システム | `TMF620` が追加された製品オファリングカタログの外部システム。 たとえば、外部システムが ABC の場合、値は `ABC-TMF620` です。 データタイプ:文字列 | | ID | 製品オファリングカタログのSys_id。 データタイプ：文字列 テーブル:製品オファリングカタログ \[sn_prd_pm_product_offering_catalog\] | | ライフサイクルステータス | 価格明細の現在のライフサイクル状況。 有効な値： * 有効 * ドラフト * 非アクティブ データタイプ：文字列 | | 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": "341f4953b71a9910ff00f203ae11a9bb", "name": "Home Internet Plan", "lifecycleStatus": "Active", "status": "published", "externalSystem": "Salesforce-TMF641" }, { "id": "69f494792b11525047f3f3e30391bf66", "name": "Chemical Processing", "lifecycleStatus": "Active", "description": " Catalog for Chemical Processing Industry", "status": "published", "externalSystem": "Salesforce-TMF620" } ] ## 製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/catalog/{id} {#ariaid-title6} 製品オファリングカタログを取得します。 ### 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\] | [表 : 25. パスパラメーター] {#tmf_prod_cat-GET-catalog-id__table_apt_nkz_gsb} {#tmf_prod_cat-GET-catalog-id__table_l5k_tkz_gsb__entry__2} | 名前 | 説明 | |-|-| | フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 データタイプ：文字列 デフォルト:すべてのフィールド。 | [表 : 26. クエリパラメーター] {#tmf_prod_cat-GET-catalog-id__table_l5k_tkz_gsb} {#tmf_prod_cat-GET-catalog-id__table_gld_vkz_gsb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 27. 要求本文パラメーター (JSON)] {#tmf_prod_cat-GET-catalog-id__table_gld_vkz_gsb} ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_cat-GET-catalog-id__table_kqy_wgy_fsb__entry__2}{#tmf_prod_cat-GET-catalog-id__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 28. 要求ヘッダー] {#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 のみをサポートします。 | [表 : 29. 応答ヘッダー] {#tmf_prod_cat-GET-catalog-id__table_tzy_thy_ksb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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 | 見つかりません。要求されたアイテムが見つかりませんでした。 | [表 : 30. ステータスコード] {#tmf_prod_cat-GET-catalog-id__table_nxj_ykz_gsb} ### 応答本文のパラメーター (JSON) {#tmf_prod_cat-GET-catalog-id__table_m2z_clz_gsb__entry__2} | 名前 | 説明 | |-|-| | description | 製品オファリングカタログの説明。 データタイプ：文字列 | | 外部システム | `TMF620` が追加された製品オファリングカタログの外部システム。 たとえば、外部システムが ABC の場合、値は `ABC-TMF620` です。 データタイプ:文字列 | | ID | 製品オファリングカタログのSys_id。 データタイプ：文字列 テーブル:製品オファリングカタログ \[sn_prd_pm_product_offering_catalog\] | | ライフサイクルステータス | 価格明細の現在のライフサイクル状況。 有効な値： * 有効 * ドラフト * 非アクティブ データタイプ：文字列 | | name | 製品オファリングカタログの名前。 データタイプ：文字列 | [ ] {#tmf_prod_cat-GET-catalog-id__table_m2z_clz_gsb} ### cURL 要求 この例では、エンタープライズモバイルプランの製品オファリングカタログを取得します。 curl --location --request GET "https://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/catalog/69f494792b11525047f3f3e30391bf66" \ --user 'username':'password' 応答本文。 { "id": "69f494792b11525047f3f3e30391bf66", "name": "Chemical Processing", "lifecycleStatus": "Active", "description": " Catalog for Chemical Processing Industry", "externalSystem": "Salesforce-TMF620" } ## 製品カタログオープン API:GET /sn_tmf_api/catalogmanagement/productOffering {#ariaid-title7} 指定されたフィルター設定に基づいて、すべての製品オファリングまたは製品オファリングのサブセットを取得します。 ### 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} | 名前 | 説明 | |-|-| | なし | | [表 : 31. パスパラメーター] {#tmf_prod_cat-GET-prodoffering__table_ofr_vgy_fsb} {#tmf_prod_cat-GET-prodoffering__table_pfr_vgy_fsb__entry__2} | 名前 | 説明 | |-|-| | フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効なフィールド： * category * チャネル * description * externalId * ID * internalId * internalVersion * 前回の更新 * name * 製品特性 * 製品オファリング価格 * productOfferingTerm * 製品仕様 * prodSpecCharValueUse * validFor * version {#tmf_prod_cat-GET-prodoffering__ul_irb_sdg_5tb} データタイプ：文字列 デフォルト：すべてのフィールドを返します。 | | limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、 offset パラメーターを使用してレコード取得をページネーションします。 データタイプ：数値 デフォルト値：20 最大:100 | | オフセット | レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。 データタイプ：数値 デフォルト：0 | | 仕様 | 製品仕様sys_idで製品オファリングをフィルタリングします。指定された製品仕様sys_idを持つ製品オファリングのみが応答に返されます。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] | | 状況 | 状態別に製品オファリングをフィルタリングします。指定されたステータスの製品オファリングのみが応答に返されます。 有効な値： * アーカイブ済み * ドラフト * 公開済み * 廃止 {#tmf_prod_cat-GET-prodoffering__ul_ndy_pcb_ccc} データタイプ：文字列 | [表 : 32. クエリパラメーター] {#tmf_prod_cat-GET-prodoffering__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodoffering__table_gld_vkz_gsb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 33. 要求本文パラメーター (JSON)] {#tmf_prod_cat-GET-prodoffering__table_gld_vkz_gsb} ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_cat-GET-prodoffering__table_kqy_wgy_fsb__entry__2}{#tmf_prod_cat-GET-prodoffering__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 34. 要求ヘッダー] {#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 ヘッダーの値は `アイテム 3 から 5` です。 | | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | | 「リンク」 | クエリ結果間を移動するための次のリンクが含まれています。 * 第 1 * 最終 * 次へ * 前へ {#tmf_prod_cat-GET-prodoffering__ul_zzk_sdm_lsb} | | X-合計-数 | ページネーションされたクエリの場合、このヘッダーはサーバーで使用可能なレコードの合計数を指定します。 | [表 : 35. 応答ヘッダー] {#tmf_prod_cat-GET-prodoffering__table_ug4_sgm_lsb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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 | レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。 | [表 : 36. ステータスコード] {#tmf_prod_cat-GET-prodoffering__table_qhs_scm_lsb} ### 応答本文のパラメーター {#tmf_prod_cat-GET-prodoffering__section_qqr_2s1_jsb} {#tmf_prod_cat-GET-prodoffering__table_rqr_2s1_jsb__entry__2}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledProductOffering-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_id-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_name-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferDefault-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_externalId-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_href-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_id-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_name-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-bundledProductOffering_version-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-displayName-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-isBundle-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-isSellable-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_description-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_name-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isDefault-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isMandatory-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor_startDateTime-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_value-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_validFor-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_validFor_startDateTime-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-prodSpecCharValueUse_valueType-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isDefault-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isMandatory-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_value-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic_name-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-productOfferingCharacteristic_valueType-entry}{#tmf_prod_cat-GET-prodoffering__prodCat-offering-status-entry} | 名前 | 説明 | |-|-| | バンドルされたグループ製品オファリング | 製品オファリングの子グループ。これらは階層的なサブグループ化を示しています。 データタイプ：オブジェクトのアレイ "bundledGroupProductOffering": [ { "bundledGroupProductOfferingOption": {Object}, "bundledProductOffering": [Array],     "id": "String",     "name": "String" } ] | | bundledGroupProductOffering。bundledGroupProductOfferingOption | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限と上限を指定する数値の範囲。 データタイプ: オブジェクト "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferLowerLimit | 関連するバンドル製品オファリングの一部として調達できる製品オファリングの下限。 データタイプ：文字列 | | bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferUpperLimit | 関連するバンドル製品オファリングの一部として調達できる製品オファリングの上限。 データタイプ：文字列 | | bundledGroupProductOffering。bundledProductOffering | バンドルに関連付けられた製品オファリングの子グループ。以下で指定する bundledProductOffering と同じ形式です。 データタイプ：オブジェクトのアレイ | | bundledGroupProductOffering。身分証明書 | バンドルされたグループレコードのSys_id。親製品オファリングまたはグループに複数のグループが含まれている場合に便利です。 データタイプ：文字列 テーブル:製品オファリングの関係グループ \[sn_prd_pm_product_offering_relationship_group\] | | bundledGroupProductOffering。名前 | 子製品オファリングのグループの名前。 データタイプ：文字列 | | バンドルされた製品オファリング | 製品オファリングバンドルに含まれる製品オファリングのリスト。製品オファリングバンドルは、含まれている製品オファリングのすべての属性を継承します。 データタイプ：オブジェクトのアレイ "bundledProductOffering": [ { "bundledProductOfferingOption": {Object},     "externalId": "String", "href": "String",     "id": "String",     "name": "String",     "version": Number } ] | | bundledProductOffering。bundledProductOfferingOption | 製品オファリングのデフォルト数や製品オファリングの上下の調達制約などの製品バンドルオプション。 データタイプ: オブジェクト "bundledProductOfferingOption": { "numberRelOfferDefault": "String", "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferDefault | 関連するバンドル製品オファリングの一部として調達する必要がある製品オファリングのデフォルト数。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferLowerLimit | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferUpperLimit | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の上限。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。externalId | 製品オファリング関係の外部 ID。 製品オファリングの関係の詳細については、「 [Create product offering relationships](https://www.servicenow.com/docs/access?context=som-product-config-offering-relationships&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 データタイプ：文字列 | | bundledProductOffering。HREF | 関連する製品オファリングへの相対リンク。 データタイプ：文字列 | | bundledProductOffering。身分証明書 | バンドルされた製品オファリングの Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] | | bundledProductOffering。名前 | 製品オファリングバンドルの名前。 データタイプ：文字列 | | bundledProductOffering。バージョン | 製品オファリングのカタログバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | | category | 製品が属するカテゴリのリスト。 データタイプ：オブジェクトのアレイ "category:" [ { "id": "String", "name": "String" } ] | | category.id | カテゴリの ID。 データタイプ：文字列 | | category.name | カテゴリの名前。 データタイプ：文字列 | | チャネル | 製品オファリングの販売に使用するチャネル。 データタイプ：オブジェクトのアレイ "channel:" [ { "description": "String", "id": "String", "name": "String" } ] | | channel.description | チャネルの説明。 データタイプ：文字列 | | channel.id | チャネルのSys_id。 データタイプ：文字列 テーブル:流通チャネル \[sn_prd_pm_distribution_channel\] | | channel.name | チャネルの名前。 データタイプ：文字列 | | description | 製品オファリングの説明。 データタイプ：文字列 | | displayName | 製品オファリングの表示名。 データタイプ：文字列 | | externalId | 製品オファリングの外部 ID。複数のバージョンが公開されている場合は、その中で最も高い公開バージョンを返します。バージョンが公開されていない場合は、ステータスに関係なく最も高いバージョンを返します。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、external_idフィールド | | 外部システム | `TMF620` が追加された製品オファリングの外部システム。 たとえば、外部システムが ABC の場合、値は `ABC-TMF620` です。 データタイプ:文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 | | ID | 必須です。製品オファリングの初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、initial_versionフィールドまたはexternal_idフィールド | | internalId | 製品オファリングレコードの Sys_id ID または内部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、initial_versionフィールド | | internalVersion | 製品オファリングのバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのバージョンフィールド。 | | バンドル | 製品オファリングがバンドルであるかどうかを示すフラグ。 可能な値： * true:製品オファリングはバンドルです。 * false:単一の製品オファリング。 データタイプ：ブーリアン デフォルト値：false | | 販売可能 | 関連付けられた製品オファリングを単独で販売できるか、または製品オファリングバンドルの一部にする必要があるかを示すフラグ。 可能な値： * true:別売りです。 * false:バンドルの一部としてのみ販売されます。 データタイプ：ブーリアン デフォルト値：false | | 前回の更新 | 製品オファリングが最後に更新された日付。 データタイプ：文字列 | | ライフサイクルステータス | 製品オファリングの現在のライフサイクルステータス。 有効な値： * 有効 * ドラフト * 非アクティブ データタイプ：文字列 デフォルト：空白の文字列 | | name | 製品オファリングの名前。 データタイプ：文字列 | | prodSpecCharValueUse | 製品オファリング特性。 データタイプ：オブジェクトのアレイ "prodSpecCharValueUse": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | prodSpecCharValueUse。形容 | 特性の説明。 データタイプ：文字列 | | prodSpecCharValueUse。名前 | 特性の名前。 データタイプ：文字列 | | prodSpecCharValueUse。productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | prodSpecCharValueUse。productSpecCharacteristicValue。isDefault | 関連する特性値が特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値。 * false:デフォルト値ではありません。 デフォルト値：false | | prodSpecCharValueUse。productSpecCharacteristicValue。必須か | 関連する特性値が特性の必須値であるかどうかを示すフラグ。 可能な値： * true:必須の値。 * false:必須の値ではありません。 デフォルト値：false | | prodSpecCharValueUse。productSpecCharacteristicValue。validFor | 特性が有効になった日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse。productSpecCharacteristicValue。validFor。startDateTime | 特性値が有効になる開始日時。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse。productSpecCharacteristicValue。価値 | 特性の値。 データタイプ：文字列 | | prodSpecCharValueUse。validFor | 特性が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse。validFor。startDateTime | 特性の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse。値タイプ | prodSpecCharValueUse.productSpecCharacteristicValue.valueパラメーターのデータタイプ。 可能な値： * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line Test * チェックボックス * 選択肢 * 日付、住所 * メール * 整数、日付/時刻 * オブジェクト * 1 行テキスト * はい/いいえ {#tmf_prod_cat-GET-prodoffering__ul_fhv_2jw_xfc} データタイプ：文字列 | | 製品特性 | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] | | productCharacteristicです。名前 | 特性の名前。 データタイプ：文字列 | | productCharacteristicです。価値 | 特性の値。 データタイプ：文字列 | | 製品オファリング特性 | 製品オファリングの特徴的な品質または特徴的な機能。特性は、モバイル計画ランクなど、設計時 (カタログオーサリング) に固定された不連続値を取ることができます。これらの特性は、通常、在庫レベルでは変更できません。 製品オファリング特性の詳細については、「 [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 データタイプ：オブジェクトのアレイ productOfferingCharacteristic": [  { "characteristicValueSpecification": [Array], "name": "String", "valueType": "String" } ] | | productOfferingCharacteristic。characteristicValueSpecification | 製品オファリング特性に関連付けられた特性値のリスト。 データタイプ：オブジェクトのアレイ "characteristicValueSpecification": [  { "isDefault": Boolean, "isMandatory": Boolean, "value": "String" }  ] | | productOfferingCharacteristic。characteristicValueSpecificationです。isDefault | 関連する特性値が関連する特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値です。 * false:デフォルト値ではありません。 データタイプ：ブーリアン デフォルト値：false | | productOfferingCharacteristic。characteristicValueSpecificationです。必須か | 関連する特性値が関連する特性に必須かどうかを示すフラグ。 可能な値： * true:必須です。 * false:必須ではありません。 データタイプ：ブーリアン デフォルト値：false | | productOfferingCharacteristic。characteristicValueSpecificationです。価値 | 関連する製品仕様特性に割り当てられた番号またはテキスト。 たとえば、次のようになります。 "characteristicValueSpecification": [ { "value": "choice 1" }, { "value": "choice 2" } ] データタイプ：文字列 | | productOfferingCharacteristic。名前 | 関連付けられた製品オファリング特性の名前。 データタイプ：文字列 | | productOfferingCharacteristic。値タイプ | productOfferingCharacteristic.characteristicValueSpecification.valueパラメーターのデータタイプ。 可能な値： * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line Test * チェックボックス * 選択肢 * 日付、住所 * メール * 整数、日付/時刻 * オブジェクト * 1 行テキスト * はい/いいえ {#tmf_prod_cat-GET-prodoffering__ul_jpt_fjw_xfc} データタイプ：文字列 | | 製品オファリング価格 | 製品オファリングの価格情報。 データタイプ：オブジェクトのアレイ "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] | | productOfferingPrice です。価格 | 製品オファリングの価格情報。 データタイプ: オブジェクト "price": { "taxIncludedAmount": {Object} } | | productOfferingPrice です。price.taxIncludedAmount | 製品オファリングの価格情報。 データタイプ: オブジェクト "taxIncludedAmount": { "unit": "String", "value": "String" } | | productOfferingPrice.price.taxIncludedAmount.unit | 製品オファリング価格の通貨コード。 データタイプ：文字列 | | productOfferingPrice.price.taxIncludedAmount.value | 税込みの製品オファリングの価格。 データタイプ：文字列 | | productOfferingPrice です。価格タイプ | 製品オファリング価格のタイプ (1 回払いまたは繰り返し支払い)。 可能な値： * 非繰り返し (1 回限り) * 繰り返し データタイプ：文字列 | | productOfferingTerm | 製品オファリングの有効な契約期間。 データタイプ：文字列 | | 製品仕様 | 製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productSpecificationです。身分証明書 | 製品仕様レコードのSys_id。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[initial_version\] フィールド。 | | productSpecificationです。内部 ID | 製品仕様レコードの Sys_id ID または内部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[initial_version\] フィールド。 | | productSpecificationです。内部バージョン | 製品仕様のバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのバージョンフィールド。 | | productSpecificationです。名前 | 製品仕様の名前。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの名前フィールド。 | | productSpecificationです。バージョン | 製品仕様の外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | | ステータス | 製品オファリングのステータス。 可能な値： * ドラフト * 公開済み データタイプ：文字列 | | validFor | 製品オファリングが有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor。endDateTime | 製品オファリングの終了日。 データタイプ：文字列 フォーマット:YYY-MM-DD | | validFor.startDateTime | 製品オファリングの開始日。 データタイプ：文字列 フォーマット:YYY-MM-DD | | バージョン | 製品オファリングの外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | [ ] {#tmf_prod_cat-GET-prodoffering__table_rqr_2s1_jsb} 次のコード例では、最初の 2 つの製品オファリングレコードを取得します。 curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productOffering?limit=2" \ --header "Accept:application/json" \ --user 'username':'password' 応答本文： [ { "id": "7b012c4d41ea7910f8771355f12634a4", "externalId": "7b012c4d41ea7910f8771355f12634a4", "href": "/api/sn_tmf_api/catalogmanagement/productOffering/0361dd9fd0a63110f8770dbf976be16f", "externalSystem": "Salesforce-TMF620", "name": "Ultimate internet - 1Gbps Plan", "displayName": "Ultimate internet - 1Gbps Plan", "description": "Ultimate internet - 1Gbps Plan", "isSellable": true, "lifecycleStatus": "Active", "isBundle": false, "lastUpdate": "2025-03-08 02:07:04", "version": "", "internalVersion": "1", "internalId": "0361dd9fd0a63110f8770dbf976be16f", "validFor": { "startDateTime": "2023-11-14", "endDateTime": "" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 0 } } } ], "productOfferingCharacteristic": "", "bundledProductOffering": [], "bundledGroupProductOffering": [], "productSpecification": {}, "prodSpecCharValueUse": [], "channel": "", "category": [ { "id": "e6f0159fd0a63110f8770dbf976be18c", "name": "Internet" } ], "status": "published" }, { "id": "313b917843235210a82ed6085bb8f2c7", "externalId": "313b917843235210a82ed6085bb8f2c7", "href": "/api/sn_tmf_api/catalogmanagement/productOffering/03c99cb53bf066509b48d69a04e45a11", "name": "Internet bundle", "displayName": "Internet bundle", "description": "Internet bundle", "isSellable": false, "lifecycleStatus": "Draft", "isBundle": true, "lastUpdate": "2025-04-09 15:59:09", "version": "", "internalVersion": "1", "internalId": "03c99cb53bf066509b48d69a04e45a11", "validFor": { "startDateTime": "2028-12-15", "endDateTime": "2034-01-14" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 0 } } } ], "productOfferingCharacteristic": [ { "name": "Connectivity need", "valueType": "choice", "characteristicValueSpecification": [ { "isMandatory": false, "isDefault": false, "value": "When in use" } ] }, { "name": "Firewall Security", "valueType": "choice", "characteristicValueSpecification": [ { "isMandatory": false, "isDefault": true, "value": "Premium" } ] } ], "bundledProductOffering": [ { "href": "/api/sn_tmf_api/catalogmanagement/productOffering/57c99cb53bf066509b48d69a04e45a17", "id": "0f61dd9fd0a63110f8770dbf976be168", "externalId": "EXT-123", "name": "Solana Sports streaming channel", "version": "1", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOffering": [ { "id": "063b957843235210a82ed6085bb8f205", "name": "Streaming Channel", "bundledProductOffering": [ { "href": "/api/sn_tmf_api/catalogmanagement/productOffering/5bc99cb53bf066509b48d69a04e45a1a", "id": "62619d9fd0a63110f8770dbf976be180", "externalId": "EXT-345", "name": "Solana Movie streaming channel", "version": "1", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6" }, "prodSpecCharValueUse": [ { "name": "Tenancy", "description": "Tenancy", "valueType": "choice", "validFor": { "startDatetime": "2025-02-27 21:04:24" }, "productSpecCharacteristicValue": [ { "value": "Premium (>50 sites)", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "Base (10 site)", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5" } } ], "channel": [ { "id": "58ad5522c3702010df4773ce3640ddb2", "name": "Agent Assist" } ], "category": [ { "id": "13e305a143b631105029d1529ab8f267", "name": "SD-WAN_all_offers" } ], "status": "draft" } ] ## 製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productOffering/{id} {#ariaid-title8} 特定の製品オファリングを取得します。 ### 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 | 取得する製品オファリングの初期バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[initial_version\] フィールド。 | [表 : 37. パスパラメーター] {#tmf_prod_cat-GET-prodoffering-id__table_apt_nkz_gsb} {#tmf_prod_cat-GET-prodoffering-id__table_pfr_vgy_fsb__entry__2} | 名前 | 説明 | |-|-| | フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効なフィールド： * category * チャネル * description * externalId * ID * internalId * internalVersion * 前回の更新 * name * 製品特性 * 製品オファリング価格 * productOfferingTerm * 製品仕様 * prodSpecCharValueUse * validFor * version {#tmf_prod_cat-GET-prodoffering-id__ul_irb_sdg_5tb} データタイプ：文字列 デフォルト：すべてのフィールドを返します。 | | 仕様 | 製品仕様sys_idで製品オファリングをフィルタリングします。指定された製品仕様sys_idを持つ製品オファリングのみが応答に返されます。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] | | 状況 | 状態別に製品オファリングをフィルタリングします。指定されたステータスの製品オファリングのみが応答に返されます。 有効な値： * アーカイブ済み * ドラフト * 公開済み * 廃止 {#tmf_prod_cat-GET-prodoffering-id__ul_ndy_pcb_ccc} データタイプ：文字列 | [表 : 38. クエリパラメーター] {#tmf_prod_cat-GET-prodoffering-id__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodoffering-id__table_gld_vkz_gsb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 39. 要求本文のパラメーター] {#tmf_prod_cat-GET-prodoffering-id__table_gld_vkz_gsb} ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_cat-GET-prodoffering-id__table_kqy_wgy_fsb__entry__2}{#tmf_prod_cat-GET-prodoffering-id__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 40. 要求ヘッダー] {#tmf_prod_cat-GET-prodoffering-id__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodoffering-id__table_tzy_thy_ksb__entry__2}{#tmf_prod_cat-GET-prodoffering-id__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 41. 応答ヘッダー] {#tmf_prod_cat-GET-prodoffering-id__table_tzy_thy_ksb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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 | 見つかりません。要求されたアイテムが見つかりませんでした。 | [表 : 42. ステータスコード] {#tmf_prod_cat-GET-prodoffering-id__table_nxj_ykz_gsb} ### 応答本文のパラメーター {#tmf_prod_cat-GET-prodoffering-id__section_qqr_2s1_jsb} {#tmf_prod_cat-GET-prodoffering-id__table_rqr_2s1_jsb__entry__2}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering_bundledProductOffering-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_id-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_name-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferDefault-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_externalId-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_href-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_id-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_name-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-bundledProductOffering_version-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-displayName-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-isBundle-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-isSellable-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_description-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_name-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isDefault-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isMandatory-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor_startDateTime-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_value-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_validFor-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_validFor_startDateTime-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-prodSpecCharValueUse_valueType-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isDefault-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isMandatory-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_value-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic_name-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-productOfferingCharacteristic_valueType-entry}{#tmf_prod_cat-GET-prodoffering-id__prodCat-offering-status-entry} | 名前 | 説明 | |-|-| | バンドルされたグループ製品オファリング | 製品オファリングの子グループ。これらは階層的なサブグループ化を示しています。 データタイプ：オブジェクトのアレイ "bundledGroupProductOffering": [ { "bundledGroupProductOfferingOption": {Object}, "bundledProductOffering": [Array],     "id": "String",     "name": "String" } ] | | bundledGroupProductOffering。bundledGroupProductOfferingOption | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限と上限を指定する数値の範囲。 データタイプ: オブジェクト "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferLowerLimit | 関連するバンドル製品オファリングの一部として調達できる製品オファリングの下限。 データタイプ：文字列 | | bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferUpperLimit | 関連するバンドル製品オファリングの一部として調達できる製品オファリングの上限。 データタイプ：文字列 | | bundledGroupProductOffering。bundledProductOffering | バンドルに関連付けられた製品オファリングの子グループ。以下で指定する bundledProductOffering と同じ形式です。 データタイプ：オブジェクトのアレイ | | bundledGroupProductOffering。身分証明書 | バンドルされたグループレコードのSys_id。親製品オファリングまたはグループに複数のグループが含まれている場合に便利です。 データタイプ：文字列 テーブル:製品オファリングの関係グループ \[sn_prd_pm_product_offering_relationship_group\] | | bundledGroupProductOffering。名前 | 子製品オファリングのグループの名前。 データタイプ：文字列 | | バンドルされた製品オファリング | 製品オファリングバンドルに含まれる製品オファリングのリスト。製品オファリングバンドルは、含まれている製品オファリングのすべての属性を継承します。 データタイプ：オブジェクトのアレイ "bundledProductOffering": [ { "bundledProductOfferingOption": {Object},     "externalId": "String", "href": "String",     "id": "String",     "name": "String",     "version": Number } ] | | bundledProductOffering。bundledProductOfferingOption | 製品オファリングのデフォルト数や製品オファリングの上下の調達制約などの製品バンドルオプション。 データタイプ: オブジェクト "bundledProductOfferingOption": { "numberRelOfferDefault": "String", "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferDefault | 関連するバンドル製品オファリングの一部として調達する必要がある製品オファリングのデフォルト数。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferLowerLimit | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferUpperLimit | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の上限。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。externalId | 製品オファリング関係の外部 ID。 製品オファリングの関係の詳細については、「 [Create product offering relationships](https://www.servicenow.com/docs/access?context=som-product-config-offering-relationships&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 データタイプ：文字列 | | bundledProductOffering。HREF | 関連する製品オファリングへの相対リンク。 データタイプ：文字列 | | bundledProductOffering。身分証明書 | バンドルされた製品オファリングの Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] | | bundledProductOffering。名前 | 製品オファリングバンドルの名前。 データタイプ：文字列 | | bundledProductOffering。バージョン | 製品オファリングのカタログバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | | category | 製品が属するカテゴリのリスト。 データタイプ：オブジェクトのアレイ "category:" [ { "id": "String", "name": "String" } ] | | category.id | カテゴリの sys_id。 データタイプ：文字列 | | category.name | カテゴリの名前。 データタイプ：文字列 | | チャネル | 製品オファリングの販売に使用するチャネル。 データタイプ：オブジェクトのアレイ "channel:" [ { "description": "String", "id": "String", "name": "String" } ] | | チャンネル。形容 | チャネルの説明。 データタイプ：文字列 | | channel.id | チャネルのSys_id。 データタイプ：文字列 テーブル:流通チャネル \[sn_prd_pm_distribution_channel\] | | channel.name | チャネルの名前。 データタイプ：文字列 | | description | 製品オファリングの説明。 データタイプ：文字列 | | displayName | 製品オファリングの表示名。 データタイプ：文字列 | | externalId | 製品オファリングの外部 ID。複数のバージョンが公開されている場合は、その中で最も高い公開バージョンを返します。バージョンが公開されていない場合は、ステータスに関係なく最も高いバージョンを返します。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、external_idフィールド | | 外部システム | `TMF620` が追加された製品オファリングの外部システム。 たとえば、外部システムが ABC の場合、値は `ABC-TMF620` です。 データタイプ:文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 | | ID | 必須です。製品オファリングの初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、initial_versionフィールドまたはexternal_idフィールド | | internalId | 製品オファリングレコードの Sys_id ID または内部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、initial_versionフィールド | | internalVersion | 製品オファリングのバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのバージョンフィールド。 | | バンドル | 製品オファリングがバンドルであるかどうかを示すフラグ。 可能な値： * true:製品オファリングはバンドルです。 * false:単一の製品オファリング。 データタイプ：ブーリアン デフォルト値：false | | 販売可能 | 関連付けられた製品オファリングを単独で販売できるか、または製品オファリングバンドルの一部にする必要があるかを示すフラグ。 可能な値： * true:別売りです。 * false:バンドルの一部としてのみ販売されます。 データタイプ：ブーリアン デフォルト値：false | | 前回の更新 | 製品オファリングが最後に更新された日付。 データタイプ：文字列 形式:YYYY-MM-DD HH-mm-SS | | ライフサイクルステータス | 製品オファリングの現在のライフサイクルステータス。 可能な値： * アクティブ * 非アクティブ * ドラフト データタイプ：文字列 デフォルト：空白の文字列 | | name | 製品オファリングの名前。 データタイプ：文字列 | | prodSpecCharValueUse | 製品オファリング特性。 データタイプ：オブジェクトのアレイ "prodSpecCharValueUse": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | prodSpecCharValueUse。形容 | 特性の説明。 データタイプ：文字列 | | prodSpecCharValueUse。名前 | 特性の名前。 データタイプ：文字列 | | prodSpecCharValueUse。productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | prodSpecCharValueUse。productSpecCharacteristicValue。isDefault | 関連する特性値が特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値。 * false:デフォルト値ではありません。 デフォルト値：false | | prodSpecCharValueUse。productSpecCharacteristicValue。必須か | 関連する特性値が特性の必須値であるかどうかを示すフラグ。 可能な値： * true:必須の値。 * false:必須の値ではありません。 デフォルト値：false | | prodSpecCharValueUse。productSpecCharacteristicValue。validFor | 特性が有効になった日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse。productSpecCharacteristicValue。validFor。startDateTime | 特性値が有効になる開始日時。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse。productSpecCharacteristicValue。価値 | 特性の値。 データタイプ：文字列 | | prodSpecCharValueUse。validFor | 特性が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse。validFor。startDateTime | 特性の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse。値タイプ | prodSpecCharValueUse.productSpecCharacteristicValue.valueパラメーターのデータタイプ。 可能な値： * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line Test * チェックボックス * 選択肢 * 日付、住所 * メール * 整数、日付/時刻 * オブジェクト * 1 行テキスト * はい/いいえ {#tmf_prod_cat-GET-prodoffering-id__ul_fhv_2jw_xfc} データタイプ：文字列 | | 製品特性 | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] | | productCharacteristicです。名前 | 特性の名前。 データタイプ：文字列 | | productCharacteristicです。価値 | 特性の値。 データタイプ：文字列 | | 製品オファリング特性 | 製品オファリングの特徴的な品質または特徴的な機能。特性は、モバイル計画ランクなど、設計時 (カタログオーサリング) に固定された不連続値を取ることができます。これらの特性は、通常、在庫レベルでは変更できません。 製品オファリング特性の詳細については、「 [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 データタイプ：オブジェクトのアレイ productOfferingCharacteristic": [  { "characteristicValueSpecification": [Array], "name": "String", "valueType": "String" } ] | | productOfferingCharacteristic。characteristicValueSpecification | 製品オファリング特性に関連付けられた特性値のリスト。 データタイプ：オブジェクトのアレイ "characteristicValueSpecification": [  { "isDefault": Boolean, "isMandatory": Boolean, "value": "String" }  ] | | productOfferingCharacteristic。characteristicValueSpecificationです。isDefault | 関連する特性値が関連する特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値です。 * false:デフォルト値ではありません。 データタイプ：ブーリアン デフォルト値：false | | productOfferingCharacteristic。characteristicValueSpecificationです。必須か | 関連する特性値が関連する特性に必須かどうかを示すフラグ。 可能な値： * true:必須です。 * false:必須ではありません。 データタイプ：ブーリアン デフォルト値：false | | productOfferingCharacteristic。characteristicValueSpecificationです。価値 | 関連する製品仕様特性に割り当てられた番号またはテキスト。 たとえば、次のようになります。 "characteristicValueSpecification": [ { "value": "choice 1" }, { "value": "choice 2" } ] データタイプ：文字列 | | productOfferingCharacteristic。名前 | 関連付けられた製品オファリング特性の名前。 データタイプ：文字列 | | productOfferingCharacteristic。値タイプ | productOfferingCharacteristic.characteristicValueSpecification.valueパラメーターのデータタイプ。 可能な値： * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line Test * チェックボックス * 選択肢 * 日付、住所 * メール * 整数、日付/時刻 * オブジェクト * 1 行テキスト * はい/いいえ {#tmf_prod_cat-GET-prodoffering-id__ul_jpt_fjw_xfc} データタイプ：文字列 | | 製品オファリング価格 | 製品オファリングの価格情報。 データタイプ：オブジェクトのアレイ "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] | | productOfferingPrice です。価格 | 製品オファリングの価格情報。 データタイプ: オブジェクト "price": { "taxIncludedAmount": {Object} } | | productOfferingPrice です。価格。税込み金額 | 製品オファリングの価格情報。 データタイプ: オブジェクト "taxIncludedAmount": { "unit": "String", "value": "String" } | | productOfferingPrice です。価格。taxIncludedAmount です。単位 | 製品オファリング価格の通貨コード。 データタイプ：文字列 | | productOfferingPrice です。価格。taxIncludedAmount です。価値 | 税込みの製品オファリングの価格。 データタイプ：文字列 | | productOfferingPrice です。価格タイプ | 製品オファリング価格が 1 回払いまたは繰り返し支払いであるかを識別します。 可能な値： * 非繰り返し * 繰り返し データタイプ：文字列 | | productOfferingTerm | 製品オファリングの有効な契約期間。 データタイプ：文字列 | | 製品仕様 | 製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productSpecificationです。身分証明書 | 製品仕様レコードのSys_id。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[initial_version\] フィールド。 | | productSpecificationです。内部 ID | 製品仕様レコードの Sys_id ID または内部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[initial_version\] フィールド。 | | productSpecificationです。内部バージョン | 製品仕様のバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのバージョンフィールド。 | | productSpecificationです。名前 | 製品仕様の名前。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの名前フィールド。 | | productSpecificationです。バージョン | 製品仕様の外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | | ステータス | 製品オファリングのステータス。 可能な値： * ドラフト * 公開済み データタイプ：文字列 | | validFor | 製品オファリングが有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor。endDateTime | 製品オファリングの終了日。 データタイプ：文字列 形式：YYYY-MM-DD | | validFor。startDateTime | 製品オファリングの開始日。 データタイプ：文字列 形式：YYYY-MM-DD | | バージョン | 製品オファリングの外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[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/03c99cb53bf066509b48d69a04e45a11" --user 'username':'password' 応答本文： { "id": "313b917843235210a82ed6085bb8f2c7", "externalId": "313b917843235210a82ed6085bb8f2c7", "href": "/api/sn_tmf_api/catalogmanagement/productOffering/03c99cb53bf066509b48d69a04e45a11", "externalSystem": "Salesforce-TMF620", "name": "Internet bundle", "displayName": "Internet bundle", "description": "Internet bundle", "isSellable": false, "lifecycleStatus": "Draft", "isBundle": true, "lastUpdate": "2025-04-09 15:59:09", "version": "", "internalVersion": "1", "internalId": "03c99cb53bf066509b48d69a04e45a11", "validFor": { "startDateTime": "2028-12-15", "endDateTime": "2034-01-14" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 0 } } } ], "productOfferingCharacteristic": [ { "name": "Connectivity need", "valueType": "choice", "characteristicValueSpecification": [ { "isMandatory": false, "isDefault": false, "value": "When in use" } ] }, { "name": "Firewall Security", "valueType": "choice", "characteristicValueSpecification": [ { "isMandatory": false, "isDefault": true, "value": "Premium" } ] } ], "bundledProductOffering": [ { "href": "/api/sn_tmf_api/catalogmanagement/productOffering/57c99cb53bf066509b48d69a04e45a17", "id": "0f61dd9fd0a63110f8770dbf976be168", "externalId": "EXT-123", "name": "Solana Sports streaming channel", "version": "1", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOffering": [ { "id": "063b957843235210a82ed6085bb8f205", "name": "Streaming Channel", "bundledProductOffering": [ { "href": "/api/sn_tmf_api/catalogmanagement/productOffering/5bc99cb53bf066509b48d69a04e45a1a", "id": "62619d9fd0a63110f8770dbf976be180", "externalId": "EXT-345", "name": "Solana Movie streaming channel", "version": "1", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6" }, "prodSpecCharValueUse": [ { "name": "Tenancy", "description": "Tenancy", "valueType": "choice", "validFor": { "startDatetime": "2025-02-27 21:04:24" }, "productSpecCharacteristicValue": [ { "value": "Premium (>50 sites)", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "Base (10 site)", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5" } } ], "channel": [ { "id": "58ad5522c3702010df4773ce3640ddb2", "name": "Agent Assist" } ], "category": [ { "id": "13e305a143b631105029d1529ab8f267", "name": "SD-WAN_all_offers" } ], "status": "draft" } ## 製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productOfferingPrice {#ariaid-title9} インスタンス内のすべての価格明細レコードを取得します。 ### URL 形式 デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice ### サポートされている要求パラメーター {#tmf_prod_order-GET-prodOfferPrice__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 43. パスパラメーター] {#tmf_prod_order-GET-prodOfferPrice__id_nzv_ycw_22c__entry__2} | 名前 | 説明 | |-|-| | 前回の更新 | 価格ラインが最後に更新された日付で結果をフィルタリングします。 形式:YYYY-MM-DD HH:mm:ss データタイプ：文字列 | | name | 指定された価格リストの名前に属する価格明細をフィルタリングします。 テーブル:価格リスト \[sn_csm_pricing_price_list\] データタイプ：文字列 | | price.value | 特定の表示価格値で結果をフィルタリングします。 データタイプ：文字列 | | priceList.id | 結果をフィルタリングして、指定されたsys_idの価格リストのみを返します。 テーブル:価格リスト \[sn_csm_pricing_price_list\] データタイプ：文字列 | | 価格タイプ | 製品オファリングの価格設定方法で結果をフィルタリングします。 有効な値： * recurring:企業は指定された頻度で繰り返し価格設定金額を請求できます。 * one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金と料金をサポートします。 データタイプ：文字列 | | productOffering です。身分証明書 | 製品オファリングのsys_idで価格明細をフィルタリングします。 テーブル:製品オファリング \[sn_prd_pm_product_offering\] データタイプ：文字列 | | unitOfMeasure です。身分証明書 | 測定単位のsys_idで価格明細をフィルタリングします。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | validFor。endDateTime | 指定された終了日時で価格明細をフィルタリングします。 形式:YYYY-MM-DD HH:mm:ss データタイプ：文字列 | | validFor。startDateTime | 指定された開始日時で価格明細をフィルタリングします。 形式:YYYY-MM-DD HH:mm:ss データタイプ：文字列 | [表 : 44. クエリパラメーター] {#tmf_prod_order-GET-prodOfferPrice__id_nzv_ycw_22c} {#tmf_prod_order-GET-prodOfferPrice__entry__26} | 名前 | 説明 | |-|-| | なし | | [表 : 45. 要求本文パラメーター (XML または JSON)] ### ヘッダー {#tmf_prod_order-GET-prodOfferPrice__section_opp_j5w_22c} 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_order-GET-prodOfferPrice__table_ppp_j5w_22c__entry__2}{#tmf_prod_order-GET-prodOfferPrice__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 46. 要求ヘッダー] {#tmf_prod_order-GET-prodOfferPrice__table_ppp_j5w_22c} {#tmf_prod_order-GET-prodOfferPrice__table_qpp_j5w_22c__entry__2} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 47. 応答ヘッダー] {#tmf_prod_order-GET-prodOfferPrice__table_qpp_j5w_22c} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#tmf_prod_order-GET-prodOfferPrice__table_fj4_nnw_22c__entry__2}{#tmf_prod_order-GET-prodOfferPrice__entry-200-status-code}{#tmf_prod_order-GET-prodOfferPrice__entry-404-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。 考えられる理由: * 無効なパスパラメーター * 無効な URI {#tmf_prod_order-GET-prodOfferPrice__ul_qkg_2rv_22c} | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | [表 : 48. ステータスコード] {#tmf_prod_order-GET-prodOfferPrice__table_fj4_nnw_22c} ### 応答本文のパラメーター (JSON または XML) {#tmf_prod_order-GET-prodOfferPrice__id_m5r_jdw_22c__entry__2}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-type}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-href}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-id}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-isBundle}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-lastUpdate}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-lifeCycleStatus}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-price}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-price.units}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-price.value}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceList}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceList.id}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceList.name}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceList.type}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceType}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-productOffering}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-productOffering.id}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-productOffering.internalVersion}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-productOffering.name}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-recurringChargePeriodType}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-unitOfMeasure}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-unitOfMeasure.amount}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-unitOfMeasure.id}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-unitOfMeasure.units}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-validFor}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-validFor.endDate}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-validFor.startDate} | 名前 | 説明 | |-|-| | @type | 価格明細のタイプ。常に `ProductOfferingPrice` の値です。 データタイプ：文字列 | | href | インスタンス内の価格明細レコードへの URL。 データタイプ：文字列 | | ID | 価格明細のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | バンドル | 価格明細が単一の製品の一部であるか、製品のバンドルの一部であるかを示すフラグ。 有効な値： * true:価格明細はバンドルの一部です。 * false:価格明細はバンドルの一部ではありません。 データタイプ：ブーリアン | | 前回の更新 | 価格明細が最後に更新された日時。 形式:YYYY-MM-DD HH:mm:ss データタイプ：文字列 | | ライフサイクルステータス | 価格明細の現在のライフサイクル状況。 有効な値： * 有効 * ドラフト * 非アクティブ データタイプ：文字列 | | 価格 | 価格明細の表示価格の詳細。 データタイプ: オブジェクト "price": { "units": "String", "value": "String" } | | price.units | 価格の通貨コード。たとえば、 `USD` や `EUR` などです。 テーブル:通貨 \[fx_currency\] データタイプ：文字列 | | price.value | 価格の値。 データタイプ:文字列 (数値で表される) | | priceList | 価格明細に関連付けられた価格リスト情報。 データタイプ: オブジェクト "priceList": { "id": "String", "name": "String", "@type": "String" } | | priceList.id | 価格リスト \[sn_csm_pricing_price_list\] テーブルの価格リストのSys_id。 データタイプ：文字列 | | priceList.name | 価格リストの名前。 データタイプ：文字列 | | priceList.@type | 価格リストのタイプ。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。常に `priceList` の値を持ちます。 データタイプ：文字列 | | 価格タイプ | この価格明細に関連付けられている製品オファリングの価格設定方法。 可能な値： * recurring:指定された頻度で繰り返し価格設定金額を請求します。recurringChargePeriodTypeの値は、充電の頻度を示します。 * one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金および料金。 データタイプ：文字列 | | productOffering | 価格明細に関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } | | productOffering.id | 製品オファリングのSys_id。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 | | productOffering です。内部バージョン | 製品オファリングの内部バージョン番号。たとえば、 `PRDOF01024` などです。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 | | productOffering です。名前 | 製品オファリングの名前。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 | | recurringChargePeriodType | この価格明細に関連付けられた製品オファリングの周期性または頻度。繰り返し`に設定されている場合`は頻度タイプpriceType返し、それ以外の場合は空の文字列を返します。 可能な値： * 年次 * 月次 データタイプ：文字列 | | 測定単位 | 価格明細に関連付けられた測定単位に関する詳細。 データタイプ: オブジェクト "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } | | unitOfMeasure.amount | 測定単位の金額。 データタイプ：数値 | | unitOfMeasure.id | 測定単位のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | unitOfMeasure です。単位 | 価格明細に関連付けられた測定単位のタイプ。たとえば、 `年` や `バンドル`などです。 データタイプ：文字列 | | validFor | 価格明細が有効な期間。 データタイプ: オブジェクト "validFor": { "endDate": "String", "startDate": "String" } | | validFor.endDate | 価格明細が有効な終了日時。 データタイプ:文字列 (glide_date_time) | | validFor.startDate | 価格明細が有効な開始日時。 データタイプ:文字列 (glide_date_time) | [ ] {#tmf_prod_order-GET-prodOfferPrice__id_m5r_jdw_22c} ### cURL 要求 次の例では、インスタンスに存在する 2 つの価格明細をすべて返します。 curl "http://instance.servicenow.com/api/sn_tmf_api/ catalogmanagement/productOfferingPrice " \ --request GET\ --user 'username':'password' 応答本文。 [ { "id": "2c4628ac7f4f9e50f8994fa63c86653c", "name": "new Price list", "lastUpdate": "2025-01-08 19:57:28", "isBundle": false, "lifecycleStatus": "Draft", "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/2c4628ac7f4f9e50f8994fa63c86653c", "validFor": { "startDateTime": "2027-03-22 22:15:58", "endDateTime": "" }, "productOffering": { "id": "f2c92ac6a5260210f8774c9b4be6ce56", "name": "Managed Connectivity Services Supreme Bundle", "internalVersion": "1" }, "priceType": "one_time", "recurringChargePeriodType": "", "unitOfMeasure": { "id": "9a7a119953020110286eddeeff7b1238", "amount": 1, "units": "Month" }, "price": { "units": "USD", "value": "800" }, "priceList": { "id": "d653246c7f4f9e50f8994fa63c86655a", "name": "new Price list", "@type": "priceList" }, "@type": "ProductOfferingPrice" }, { "id": "dfb7ec607f8f9e50f8994fa63c866569", "name": "new Price list", "lastUpdate": "2025-01-08 19:57:46", "isBundle": false, "lifecycleStatus": "Draft", "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/dfb7ec607f8f9e50f8994fa63c866569", "validFor": { "startDateTime": "2026-05-28 22:15:58", "endDateTime": "" }, "productOffering": { "id": "f2c92ac6a5260210f8774c9b4be6ce56", "name": "Managed Connectivity Services Supreme Bundle", "internalVersion": "1" }, "priceType": "one_time", "recurringChargePeriodType": "", "unitOfMeasure": { "id": "1eaa559953020110286eddeeff7b12c7", "amount": 1, "units": "Year" }, "price": { "units": "USD", "value": "800" }, "priceList": { "id": "d653246c7f4f9e50f8994fa63c86655a", "name": "new Price list", "@type": "priceList" }, "@type": "ProductOfferingPrice" } ] ## 製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productOfferingPrice/{id} {#ariaid-title10} 特定の価格明細に関する詳細を取得します。 ### URL 形式 デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice/{id} ### サポートされている要求パラメーター {#tmf_prod_cat-GET-prodofferprice-id__entry__2} | 名前 | 説明 | |-|-| | ID | 必須です。取得する価格明細のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | [表 : 49. パスパラメーター] {#tmf_prod_cat-GET-prodofferprice-id__id_itn_xcw_22c__entry__2} | 名前 | 説明 | |-|-| | 前回の更新 | 価格ラインが最後に更新された日付で結果をフィルタリングします。 形式:YYYY-MM-DD HH:mm:ss データタイプ：文字列 | | name | 指定された価格リストの名前に属する価格明細をフィルタリングします。 テーブル:価格リスト \[sn_csm_pricing_price_list\] データタイプ：文字列 | | price.value | 特定の表示価格値で結果をフィルタリングします。 データタイプ：文字列 | | priceList.id | 結果をフィルタリングして、指定されたsys_idの価格リストのみを返します。 テーブル:価格リスト \[sn_csm_pricing_price_list\] データタイプ：文字列 | | 価格タイプ | 製品オファリングの価格設定方法で結果をフィルタリングします。 有効な値： * recurring:企業は指定された頻度で繰り返し価格設定金額を請求できます。 * one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金と料金をサポートします。 データタイプ：文字列 | | productOffering です。身分証明書 | 製品オファリングのsys_idで価格明細をフィルタリングします。 テーブル:製品オファリング \[sn_prd_pm_product_offering\] データタイプ：文字列 | | unitOfMeasure です。身分証明書 | 測定単位のsys_idで価格明細をフィルタリングします。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | validFor。endDateTime | 指定された終了日時で価格明細をフィルタリングします。 形式:YYYY-MM-DD HH:mm:ss データタイプ：文字列 | | validFor。startDateTime | 指定された開始日時で価格明細をフィルタリングします。 形式:YYYY-MM-DD HH:mm:ss データタイプ：文字列 | [表 : 50. クエリパラメーター] {#tmf_prod_cat-GET-prodofferprice-id__id_itn_xcw_22c} {#tmf_prod_cat-GET-prodofferprice-id__entry__26} | 名前 | 説明 | |-|-| | なし | | [表 : 51. 要求本文パラメーター (XML または JSON)] ### ヘッダー {#tmf_prod_cat-GET-prodofferprice-id__section_ert_35w_22c} 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_cat-GET-prodofferprice-id__table_frt_35w_22c__entry__2}{#tmf_prod_cat-GET-prodofferprice-id__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 52. 要求ヘッダー] {#tmf_prod_cat-GET-prodofferprice-id__table_frt_35w_22c} {#tmf_prod_cat-GET-prodofferprice-id__table_grt_35w_22c__entry__2} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 53. 応答ヘッダー] {#tmf_prod_cat-GET-prodofferprice-id__table_grt_35w_22c} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#tmf_prod_cat-GET-prodofferprice-id__entry__38}{#tmf_prod_cat-GET-prodofferprice-id__entry-200-status-code}{#tmf_prod_cat-GET-prodofferprice-id__entry-404-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。 考えられる理由: * 無効なパスパラメーター * 無効な URI {#tmf_prod_cat-GET-prodofferprice-id__ul_qkg_2rv_22c} | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | [表 : 54. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#tmf_prod_cat-GET-prodofferprice-id__id_ksw_ldw_22c__entry__2}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-type}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-href}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-id}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-isBundle}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-lastUpdate}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-lifeCycleStatus}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-price}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-price.units}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-price.value}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceList}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceList.id}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceList.name}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceList.type}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceType}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-productOffering}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-productOffering.id}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-productOffering.internalVersion}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-productOffering.name}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-recurringChargePeriodType}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-unitOfMeasure}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-unitOfMeasure.amount}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-unitOfMeasure.id}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-unitOfMeasure.units}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-validFor}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-validFor.endDate}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-validFor.startDate} | 名前 | 説明 | |-|-| | @type | 価格明細のタイプ。常に `ProductOfferingPrice` の値です。 データタイプ：文字列 | | href | インスタンス内の価格明細レコードへの URL。 データタイプ：文字列 | | ID | 価格明細のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | バンドル | 価格明細が単一の製品の一部であるか、製品のバンドルの一部であるかを示すフラグ。 有効な値： * true:価格明細はバンドルの一部です。 * false:価格明細はバンドルの一部ではありません。 データタイプ：ブーリアン | | 前回の更新 | 価格明細が最後に更新された日時。 形式:YYYY-MM-DD HH:mm:ss データタイプ：文字列 | | ライフサイクルステータス | 価格明細の現在のライフサイクル状況。 有効な値： * 有効 * ドラフト * 非アクティブ データタイプ：文字列 | | 価格 | 価格明細の表示価格の詳細。 データタイプ: オブジェクト "price": { "units": "String", "value": "String" } | | price.units | 価格の通貨コード。たとえば、 `USD` や `EUR` などです。 テーブル:通貨 \[fx_currency\] データタイプ：文字列 | | price.value | 価格の値。 データタイプ:文字列 (数値で表される) | | priceList | 価格明細に関連付けられた価格リスト情報。 データタイプ: オブジェクト "priceList": { "id": "String", "name": "String", "@type": "String" } | | priceList.id | 価格リスト \[sn_csm_pricing_price_list\] テーブルの価格リストのSys_id。 データタイプ：文字列 | | priceList.name | 価格リストの名前。 データタイプ：文字列 | | priceList.@type | 価格リストのタイプ。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。常に `priceList` の値を持ちます。 データタイプ：文字列 | | 価格タイプ | この価格明細に関連付けられている製品オファリングの価格設定方法。 可能な値： * recurring:指定された頻度で繰り返し価格設定金額を請求します。recurringChargePeriodTypeの値は、充電の頻度を示します。 * one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金および料金。 データタイプ：文字列 | | productOffering | 価格明細に関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } | | productOffering.id | 製品オファリングのSys_id。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 | | productOffering です。内部バージョン | 製品オファリングの内部バージョン番号。たとえば、 `PRDOF01024` などです。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 | | productOffering です。名前 | 製品オファリングの名前。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 | | recurringChargePeriodType | この価格明細に関連付けられた製品オファリングの周期性または頻度。繰り返し`に設定されている場合`は頻度タイプpriceType返し、それ以外の場合は空の文字列を返します。 可能な値： * 年次 * 月次 データタイプ：文字列 | | 測定単位 | 価格明細に関連付けられた測定単位に関する詳細。 データタイプ: オブジェクト "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } | | unitOfMeasure.amount | 測定単位の金額。 データタイプ：数値 | | unitOfMeasure.id | 測定単位のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | unitOfMeasure です。単位 | 価格明細に関連付けられた測定単位のタイプ。たとえば、 `年` や `バンドル`などです。 データタイプ：文字列 | | validFor | 価格明細が有効な期間。 データタイプ: オブジェクト "validFor": { "endDate": "String", "startDate": "String" } | | validFor.endDate | 価格明細が有効な終了日時。 データタイプ:文字列 (glide_date_time) | | validFor.startDate | 価格明細が有効な開始日時。 データタイプ:文字列 (glide_date_time) | [ ] {#tmf_prod_cat-GET-prodofferprice-id__id_ksw_ldw_22c} ### cURL 要求 次の例は、ID dfb7ec60... curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOfferingPrice/dfb7ec607f8f9e50f8994fa63c866569" \ --request GET\ --user 'username':'password' 応答。 { "id": "dfb7ec607f8f9e50f8994fa63c866569", "name": "new Price list", "lastUpdate": "2025-01-08 19:57:46", "isBundle": false, "lifecycleStatus": "Draft", "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/dfb7ec607f8f9e50f8994fa63c866569", "validFor": { "startDateTime": "2026-05-28 22:15:58", "endDateTime": "" }, "productOffering": { "id": "f2c92ac6a5260210f8774c9b4be6ce56", "name": "Managed Connectivity Services Supreme Bundle", "internalVersion": "1" }, "priceType": "one_time", "recurringChargePeriodType": "", "unitOfMeasure": { "id": "1eaa559953020110286eddeeff7b12c7", "amount": 1, "units": "Year" }, "price": { "units": "USD", "value": "800" }, "priceList": { "id": "d653246c7f4f9e50f8994fa63c86655a", "name": "new Price list", "@type": "priceList" }, "@type": "ProductOfferingPrice" } ## 製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productSpecification {#ariaid-title11} すべての製品仕様レコードを取得します。 ### 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} | 名前 | 説明 | |-|-| | なし | | [表 : 55. パスパラメーター] {#tmf_prod_cat-GET-prodspec__table_ofr_vgy_fsb} {#tmf_prod_cat-GET-prodspec__table_pfr_vgy_fsb__entry__2} | 名前 | 説明 | |-|-| | フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効なフィールド： * description * externalId * ID * internalId * internalVersion * 前回の更新 * name * 製品仕様特性 * 製品仕様関係 * リソース仕様 * サービス仕様 * validFor * version {#tmf_prod_cat-GET-prodspec__ul_n1h_htz_54b} データタイプ：文字列 デフォルト：すべてのフィールドを返します。 | | limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、 offset パラメーターを使用してレコード取得をページネーションします。 データタイプ：数値 デフォルト値：20 最大:100 | | オフセット | レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。 データタイプ：数値 デフォルト：0 | | 状況 | 製品仕様をステータス別にフィルタリングします。指定されたステータスの製品仕様のみが応答に返されます。 指定できる値: * アーカイブ済み * ドラフト * 公開済み * 廃止 {#tmf_prod_cat-GET-prodspec__ul_ngb_qcb_ccc} データタイプ：文字列 | [表 : 56. クエリパラメーター] {#tmf_prod_cat-GET-prodspec__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodspec__table_gld_vkz_gsb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 57. 要求本文パラメーター (JSON)] {#tmf_prod_cat-GET-prodspec__table_gld_vkz_gsb} ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_cat-GET-prodspec__table_kqy_wgy_fsb__entry__2}{#tmf_prod_cat-GET-prodspec__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 58. 要求ヘッダー] {#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 ヘッダーの値は `アイテム 3 から 5` です。 | | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | | 「リンク」 | クエリ結果間を移動するための次のリンクが含まれています。 * 第 1 * 最終 * 次へ * 前へ {#tmf_prod_cat-GET-prodspec__ul_zzk_sdm_lsb} | | X-合計-数 | ページネーションされたクエリの場合、このヘッダーはサーバーで使用可能なレコードの合計数を指定します。 | [表 : 59. 応答ヘッダー] {#tmf_prod_cat-GET-prodspec__table_pkr_rgm_lsb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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 | レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。 | [表 : 60. ステータスコード] {#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}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_compatibilityRelationshipType-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_id-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_internalId-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_internalVersion-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_name-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_prodSpecRelationshipOption-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_prodSpecRelationshipOption_numberSpecRelDefault-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_prodSpecRelationshipOption_numberSpecRelLowerLimit-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_prodSpecRelationshipOption_numberSpecRelUpperLimit-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_type-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_validFor-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_validFor_endDateTime-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_validFor_startDateTime-entry}{#tmf_prod_cat-GET-prodspec__productSpecificationRelationship_validFor_version-entry} | 名前 | 説明 | |-|-| | description | 仕様の説明。 データタイプ：文字列 | | displayName | 製品仕様の表示名。 データタイプ：文字列 | | externalId | 製品仕様の外部 ID。複数のバージョンが公開されている場合は、その中で最も高い公開バージョンを返します。バージョンが公開されていない場合は、ステータスに関係なく最も高いバージョンを返します。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのexternal_idフィールド内。 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 | | 外部システム | `TMF620` が追加された製品仕様の外部システム。 たとえば、外部システムが ABC の場合、値は `ABC-TMF620` です。 データタイプ:文字列 | | ID | 製品仕様の Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | internalId | 製品仕様のSys_idまたは内部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルの initial_version フィールド内。 | | internalVersion | 製品仕様のバージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのバージョンフィールド。 | | バンドル | productSpecificationが単一の製品を表すか、製品のバンドルを表すかを示すフラグ。 可能な値： * true:製品仕様は製品バンドルであり、複数の製品が含まれています。 * false:製品仕様には単一の製品が含まれています。 データタイプ：ブーリアン | | 前回の更新 | 仕様が最後に更新された日付。 データタイプ：文字列 | | ライフサイクルステータス | 製品仕様の現在のライフサイクル状況。 可能な値： * アクティブ * 非アクティブ * ドラフト データタイプ：文字列 | | name | 仕様の名前。 データタイプ：文字列 | | 製品仕様特性 | 製品仕様特性。 データタイプ：オブジェクトのアレイ "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | productSpecCharacteristicです。形容 | 特性の説明。 データタイプ：文字列 | | productSpecCharacteristicです。名前 | 特性の名前。 データタイプ：文字列 | | productSpecCharacteristicです。productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | productSpecCharacteristicです。productSpecCharacteristicValue。isDefault | 関連する特性値が特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値。 * false:デフォルト値ではありません。 デフォルト値：false | | productSpecCharacteristicです。productSpecCharacteristicValue。必須か | 関連する特性値が特性の必須値であるかどうかを示すフラグ。 可能な値： * true:必須の値。 * false:必須の値ではありません。 デフォルト値：false | | productSpecCharacteristicです。productSpecCharacteristicValue。validFor | 特性が有効になった日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | productSpecCharacteristicです。productSpecCharacteristicValue。validFor。startDateTime | 特性値が有効になる開始日時。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | productSpecCharacteristicです。productSpecCharacteristicValue。価値 | 特性の値。 データタイプ：文字列 | | productSpecCharacteristicです。validFor | 特性が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | productSpecCharacteristicです。validFor。startDateTime | 特性の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | productSpecCharacteristicです。値タイプ | 特性の値タイプ (選択肢やメールなど)。複合型または非複合型にすることができます。 データタイプ：文字列 指定できる値: * 日付、住所 * 整数、日付/時刻 * Array.Integer * Array.Single Line Test * 1 行テスト * Array.Object * Array.Date * Array.Decimal * はい/いいえ * オブジェクト * Array.Datetime * チェックボックス * メール * 選択肢 {#tmf_prod_cat-GET-prodspec__ul_khq_trk_tfc} | | 製品仕様関係 | この仕様と他の製品仕様との関係。 データタイプ：オブジェクトのアレイ "productSpecificationRelationship": [ { "compatibilityRelationshipType": "String", "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "prodSpecRelationshipOption": {Object}, "type": "String", "validFor": {Object}, "version": "String" ] | | productSpecificationRelationship。compatibilityRelationshipType | 製品仕様の互換性関係タイプに必要な値。 互換性関係の詳細については、「 [Configuring compatibility rules for horizontal relationships](https://www.servicenow.com/docs/access?context=order-mgt-compatibility-management&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 テーブル:互換性 \[sn_compt_mgmt_compatibles\] | | productSpecificationRelationship.id | 関連仕様のSys_id。 データタイプ：文字列 | | productSpecificationRelationship。内部 ID | 製品仕様関係のSys_id (内部 ID)。 データタイプ：文字列 | | productSpecificationRelationship。内部バージョン | 製品仕様関係のバージョン。 データタイプ：文字列 | | productSpecificationRelationship。名前 | 製品仕様関係の名前。 データタイプ：文字列 | | productSpecificationRelationship。prodSpecRelationshipOption | 製品仕様関係のカーディナリティ。 データタイプ: オブジェクト "prodSpecRelationshipOption": { "numberSpecRelDefault": "String", "numberSpecRelLowerLimit": "String", "numberSpecRelUpperLimit": "String" } | | productSpecificationRelationship。prodSpecRelationshipOption。numberSpecRelDefault | 製品仕様のデフォルト値。 データタイプ：文字列 | | productSpecificationRelationship。prodSpecRelationshipOption。numberSpecRelLowerLimit | 購入可能な注文の最小数。 データタイプ：文字列 | | productSpecificationRelationship。prodSpecRelationshipOption。numberSpecRelUpperLimit | 購入可能な注文の最大数。 データタイプ：文字列 | | productSpecificationRelationship。種類 | 製品仕様関係のタイプ。 データタイプ：文字列 | | productSpecificationRelationship。validFor | 製品仕様関係が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecificationRelationship。validFor。endDateTime | 関係の終了日。 データタイプ：文字列 | | productSpecificationRelationship。validFor。startDateTime | 関係の開始日。 データタイプ：文字列 | | productSpecificationRelationship。バージョン | 製品仕様関係のバージョン。 データタイプ：文字列 | | リソース仕様 | この製品仕様に関連するリソース仕様のリスト。 データタイプ：オブジェクトのアレイ "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | resourceSpecification です。身分証明書 | リソース仕様の Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | resourceSpecification です。内部 ID | リソース仕様レコードの初期バージョン (sys_id)。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの initial_version フィールド。 | | resourceSpecification です。内部バージョン | リソース仕様のバージョン。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルのバージョンフィールド。 | | resourceSpecification です。名前 | リソース仕様の名前。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] | | resourceSpecification です。バージョン | リソース仕様の外部バージョン。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの external_version フィールド内。 | | サービス仕様 | この製品仕様に関連するサービス仕様のリスト。 データタイプ：オブジェクトのアレイ "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | serviceSpecificationです。身分証明書 | サービス仕様の初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | serviceSpecificationです。内部 ID | サービス仕様の初期バージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルの initial_version フィールド。 | | serviceSpecificationです。内部バージョン | サービス仕様のバージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルのバージョンフィールド。 | | serviceSpecificationです。名前 | サービス仕様の名前。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] | | serviceSpecificationです。バージョン | サービス仕様の外部バージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルの external_version フィールド。 | | ステータス | 製品仕様のステータス。 可能な値： * ドラフト * 公開済み データタイプ：文字列 | | validFor | 仕様が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor。endDateTime | 仕様の終了日。 データタイプ：文字列 形式：YYYY-MM-DD | | validFor。startDateTime | 仕様の開始日。 データタイプ：文字列 形式：YYYY-MM-DD | | バージョン | 製品仕様の外部バージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルの external_version フィールド。 | [ ] {#tmf_prod_cat-GET-prodspec__table_zmb_ccb_jsb} ### cURL 要求 この例では、最初の 2 つの製品仕様レコードを取得します。 curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification?limit=2" \ --header "Accept:application/json" \ --user 'username':'password' 応答本文： [ { "id": "0435b48a742e4a10f877468e695efa3c", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/0435b48a742e4a10f877468e695efa3c", "externalSystem": "Salesforce-TMF620", "name": "Managed PoS PS", "displayName": "Managed PoS PS", "version": "", "internalVersion": "1", "internalId": "0435b48a742e4a10f877468e695efa3c", "description": "Managed PoS PS", "lastUpdate": "2032-09-26 20:07:12", "lifecycleStatus": "Active", "isBundle": false, "validFor": { "startDateTime": "2032-09-26", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [], "resourceSpecification": [], "productSpecCharacteristic": [ { "productSpecCharacteristicValue": [ { "value": "4", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": true }, { "value": "2", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": true }, { "value": "1", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": true } ], "name": "Number of POS Terminals", "description": "Number of POS Terminals", "valueType": "choice", "validFor": { "startDatetime": "2024-05-31 21:43:14" } }, { "productSpecCharacteristicValue": [ { "value": "Gold", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": true }, { "value": "Bronze", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": true }, { "value": "Silver", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": true } ], "name": "Managed Service Level", "description": "Managed Service Level", "valueType": "choice", "validFor": { "startDatetime": "2024-05-31 21:15:24" } } ], "status": "published" }, { "id": "1a0936f840102610f87798b149fd435d", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/1a0936f840102610f87798b149fd435d", "name": "Wi-Fi Configuration Setup Service PS", "displayName": "Wi-Fi Configuration Setup Service PS", "version": "", "internalVersion": "1", "internalId": "1a0936f840102610f87798b149fd435d", "description": "Wi-Fi Configuration Setup Service PS", "lastUpdate": "2025-03-13 21:01:14", "lifecycleStatus": "Active", "isBundle": false, "validFor": { "startDateTime": "2025-03-12", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [], "resourceSpecification": [], "productSpecCharacteristic": [], "status": "published" } ] ## 製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productSpecification/{id} {#ariaid-title12} 指定された製品仕様レコードを取得します。 ### 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} | 名前 | 説明 | |-|-| | ID | 取得する製品仕様のSys_idまたは初期バージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのsys_idフィールドまたはinitial_versionフィールド。 | [表 : 61. パスパラメーター] {#tmf_prod_cat-GET-prodspec-id__table_apt_nkz_gsb} {#tmf_prod_cat-GET-prodspec-id__table_pfr_vgy_fsb__entry__2} | 名前 | 説明 | |-|-| | フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効なフィールド： * description * externalId * ID * internalId * internalVersion * 前回の更新 * name * 製品仕様特性 * 製品仕様関係 * リソース仕様 * サービス仕様 * validFor * version {#tmf_prod_cat-GET-prodspec-id__ul_n1h_htz_54b} データタイプ：文字列 デフォルト：すべてのフィールドを返します。 | | 状況 | 製品仕様をステータス別にフィルタリングします。指定されたステータスの製品仕様のみが応答に返されます。 指定できる値: * アーカイブ済み * ドラフト * 公開済み * 廃止 {#tmf_prod_cat-GET-prodspec-id__ul_ngb_qcb_ccc} データタイプ：文字列 | [表 : 62. クエリパラメーター] {#tmf_prod_cat-GET-prodspec-id__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodspec-id__table_gld_vkz_gsb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 63. 要求本文のパラメーター] {#tmf_prod_cat-GET-prodspec-id__table_gld_vkz_gsb} ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_cat-GET-prodspec-id__table_kqy_wgy_fsb__entry__2}{#tmf_prod_cat-GET-prodspec-id__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 64. 要求ヘッダー] {#tmf_prod_cat-GET-prodspec-id__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodspec-id__table_tzy_thy_ksb__entry__2} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 65. 応答ヘッダー] {#tmf_prod_cat-GET-prodspec-id__table_tzy_thy_ksb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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 | 見つかりません。要求されたアイテムが見つかりませんでした。 | [表 : 66. ステータスコード] {#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}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_compatibilityRelationshipType-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_id-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_internalId-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_internalVersion-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_name-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_prodSpecRelationshipOption-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_prodSpecRelationshipOption_numberSpecRelDefault-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_prodSpecRelationshipOption_numberSpecRelLowerLimit-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_prodSpecRelationshipOption_numberSpecRelUpperLimit-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_type-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_validFor-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_validFor_endDateTime-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_validFor_startDateTime-entry}{#tmf_prod_cat-GET-prodspec-id__productSpecificationRelationship_validFor_version-entry} | 名前 | 説明 | |-|-| | description | 仕様の説明。 データタイプ：文字列 | | displayName | 製品仕様の表示名。 データタイプ：文字列 | | externalId | 製品仕様の外部 ID。複数のバージョンが公開されている場合は、その中で最も高い公開バージョンを返します。バージョンが公開されていない場合は、ステータスに関係なく最も高いバージョンを返します。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのexternal_idフィールド内。 | | 外部システム | `TMF620` が追加された製品仕様の外部システム。 たとえば、外部システムが ABC の場合、値は `ABC-TMF620` です。 データタイプ:文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 | | ID | 製品仕様の Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | internalId | 製品仕様のSys_idまたは内部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルの initial_version フィールド内。 | | internalVersion | 製品仕様のバージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのバージョンフィールド。 | | バンドル | productSpecificationが単一の製品を表すか、製品のバンドルを表すかを示すフラグ。 有効な値： * true:製品仕様は製品バンドルであり、複数の製品が含まれています。 * false:製品仕様には単一の製品が含まれています。 {#tmf_prod_cat-GET-prodspec-id__ul_rry_rz4_4bc} データタイプ：ブーリアン デフォルト値：false | | 前回の更新 | 製品仕様が最後に更新された日付。 データタイプ：文字列 | | ライフサイクルステータス | 製品仕様の現在のライフサイクル状況。 有効な値： * 有効 * ドラフト * 非アクティブ データタイプ：文字列 デフォルト：空白の文字列 | | 名前 | 製品仕様の名前。 データタイプ：文字列 | | 製品仕様特性 | 製品仕様特性。 データタイプ：オブジェクトのアレイ "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | productSpecCharacteristicです。形容 | 特性の説明。 データタイプ：文字列 | | productSpecCharacteristicです。名前 | 特性の名前。 データタイプ：文字列 | | productSpecCharacteristicです。productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | productSpecCharacteristicです。productSpecCharacteristicValue。isDefault | 関連する特性値が特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値。 * false:デフォルト値ではありません。 デフォルト値：false | | productSpecCharacteristicです。productSpecCharacteristicValue。必須か | 関連する特性値が特性の必須値であるかどうかを示すフラグ。 可能な値： * true:必須の値。 * false:必須の値ではありません。 デフォルト値：false | | productSpecCharacteristicです。productSpecCharacteristicValue。validFor | 特性が有効になった日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | productSpecCharacteristicです。productSpecCharacteristicValue。validFor。startDateTime | 特性値が有効になる開始日時。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | productSpecCharacteristicです。productSpecCharacteristicValue。価値 | 特性の値。 データタイプ：文字列 | | productSpecCharacteristicです。validFor | 特性が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | productSpecCharacteristicです。validFor。startDateTime | 特性の開始日。 データタイプ：文字列 | | productSpecCharacteristicです。値タイプ | 特性の値タイプ。選択肢やメールなど、複合タイプまたは非複合タイプにすることができます。 指定できる値: * 日付、住所 * 整数、日付/時刻 * Array.Integer * Array.Single Line Test * 1 行テスト * Array.Object * Array.Date * Array.Decimal * はい/いいえ * オブジェクト * Array.Datetime * チェックボックス * メール * 選択肢 {#tmf_prod_cat-GET-prodspec-id__ul_khq_trk_tfc} データタイプ：文字列 | | 製品仕様関係 | この仕様と他の製品仕様との関係。 データタイプ：オブジェクトのアレイ "productSpecificationRelationship": [ { "compatibilityRelationshipType": "String", "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "prodSpecRelationshipOption": {Object}, "type": "String", "validFor": {Object}, "version": "String" ] | | productSpecificationRelationship。compatibilityRelationshipType | 製品仕様の互換性関係タイプに必要な値。 互換性関係の詳細については、「 [Configuring compatibility rules for horizontal relationships](https://www.servicenow.com/docs/access?context=order-mgt-compatibility-management&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 テーブル:互換性 \[sn_compt_mgmt_compatibles\] | | productSpecificationRelationship.id | 関連仕様のSys_id。 データタイプ：文字列 | | productSpecificationRelationship。内部 ID | 製品仕様関係のSys_id (内部 ID)。 データタイプ：文字列 | | productSpecificationRelationship。内部バージョン | 製品仕様関係のバージョン。 データタイプ：文字列 | | productSpecificationRelationship。名前 | 製品仕様関係の名前。 データタイプ：文字列 | | productSpecificationRelationship。prodSpecRelationshipOption | 製品仕様関係のカーディナリティ。 データタイプ: オブジェクト "prodSpecRelationshipOption": { "numberSpecRelDefault": "String", "numberSpecRelLowerLimit": "String", "numberSpecRelUpperLimit": "String" } | | productSpecificationRelationship。prodSpecRelationshipOption。numberSpecRelDefault | 製品仕様のデフォルト値。 データタイプ：文字列 | | productSpecificationRelationship。prodSpecRelationshipOption。numberSpecRelLowerLimit | 購入可能な注文の最小数。 データタイプ：文字列 | | productSpecificationRelationship。prodSpecRelationshipOption。numberSpecRelUpperLimit | 購入可能な注文の最大数。 データタイプ：文字列 | | productSpecificationRelationship。種類 | 製品仕様関係のタイプ。 データタイプ：文字列 | | productSpecificationRelationship。validFor | 製品仕様関係が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecificationRelationship。validFor。endDateTime | 関係の終了日。 データタイプ：文字列 | | productSpecificationRelationship。validFor。startDateTime | 関係の開始日。 データタイプ：文字列 | | productSpecificationRelationship。バージョン | 製品仕様関係のバージョン。 データタイプ：文字列 | | リソース仕様 | この製品仕様に関連するリソース仕様のリスト。 データタイプ：オブジェクトのアレイ "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | resourceSpecification です。身分証明書 | リソース仕様の Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | resourceSpecification です。内部 ID | リソース仕様レコードの初期バージョン (sys_id)。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの initial_version フィールド。 | | resourceSpecification です。内部バージョン | リソース仕様のバージョン。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルのバージョンフィールド。 | | resourceSpecification です。名前 | リソース仕様の名前。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] | | resourceSpecification です。バージョン | リソース仕様の外部バージョン。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの external_version フィールド内。 | | サービス仕様 | この製品仕様に関連するサービス仕様のリスト。 データタイプ：オブジェクトのアレイ "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | serviceSpecificationです。身分証明書 | サービス仕様の初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | serviceSpecificationです。内部 ID | サービス仕様の初期バージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルの initial_version フィールド。 | | serviceSpecificationです。内部バージョン | サービス仕様のバージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルのバージョンフィールド。 | | serviceSpecificationです。名前 | サービス仕様の名前。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] | | serviceSpecificationです。バージョン | サービス仕様の外部バージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルの external_version フィールド。 | | ステータス | 製品仕様のステータス。 可能な値： * ドラフト * 公開済み データタイプ：文字列 | | validFor | 仕様が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor。endDateTime | 仕様の終了日。 データタイプ：文字列 | | validFor。startDateTime | 仕様の開始日。 データタイプ：文字列 | | バージョン | 製品仕様の外部バージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルの external_version フィールド。 | [ ] {#tmf_prod_cat-GET-prodspec-id__table_zmb_ccb_jsb} この例では、指定された製品仕様レコードを取得します。 curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6" \ --header "Accept:application/json" \ --user 'username':'password' 応答本文： { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/497a39a7c3d312105acc9e62b540dd14",, "externalSystem": "Salesforce-TMF620", "name": "SD-WAN Service Package", "displayName": "SD-WAN Service Package v4", "version": "", "internalVersion": "4", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "description": "SD WAN Service Package", "lastUpdate": "2029-04-15 20:05:37", "lifecycleStatus": "Active", "isBundle": true, "validFor": { "startDateTime": "2033-04-15", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [ { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "", "internalVersion": "2", "internalId": "a6514bd3534560102f18ddeeff7b1247", "type": "Service", "compatibilityRelationshipType": "", "validFor": { "startDateTime": "2030-09-25", "endDateTime": "2035-10-27" } }, { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "", "internalVersion": "2", "internalId": "39b627aa53702010cd6dddeeff7b1202", "type": "Service", "compatibilityRelationshipType": "", "validFor": { "startDateTime": "2030-09-27", "endDateTime": "2035-10-27" } }, { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "2", "internalId": "216663aa53702010cd6dddeeff7b12b5", "type": "Service", "compatibilityRelationshipType": "", "validFor": { "startDateTime": "2029-04-03", "endDateTime": "" } } ], "resourceSpecification": [], "productSpecCharacteristic": [ { "productSpecCharacteristicValue": [ { "value": "0.01", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "0.25", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "0.5", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "1", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Down Time", "description": "Down Time", "valueType": "choice", "validFor": { "startDatetime": "2027-12-13 02:36:15" } }, { "productSpecCharacteristicValue": [ { "value": "1 hr", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "2 hrs", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "4 hrs", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Mean Time to Restore (MTR)", "description": "Mean Time to Restore (MTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-12-13 02:39:05" } }, { "productSpecCharacteristicValue": [ { "value": "1 hr", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "4 hrs", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "2 hrs", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Time to Restore (TTR)", "description": "Time to Restore (TTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-12-13 02:37:25" } }, { "productSpecCharacteristicValue": [ { "value": "99.50", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "99.99", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "99.00", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "99.75", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Up Time", "description": "Up time", "valueType": "choice", "validFor": { "startDatetime": "2027-12-13 02:34:30" } }, { "productSpecCharacteristicValue": [ { "value": "5 Gbps", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "1 Gbps", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "500 Mbps", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "2 Gbps", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Bandwidth", "description": "Bandwidth", "valueType": "choice", "validFor": { "startDatetime": "2027-12-13 02:32:11" } }, { "productSpecCharacteristicValue": [ { "value": "Yes", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "No", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Application Encryption", "description": "Application Encryption", "valueType": "yes_no", "validFor": { "startDatetime": "2027-12-13 02:29:08" } }, { "productSpecCharacteristicValue": [ { "value": "Yes", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false }, { "value": "No", "validFor": { "startDateTime": "" }, "isDefault": false, "isMandatory": false } ], "name": "Application Flow Backup", "description": "Application Flow Backup", "valueType": "yes_no", "validFor": { "startDatetime": "2027-12-13 02:30:39" } } ], "status": "published" } ## 製品カタログオープン API - PATCH /sn_tmf_api/catalogmanagement/productOffering/{id} {#ariaid-title13} 指定された製品オファリングを更新します。 ### 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\] | [表 : 67. パスパラメーター] {#tmf_prod_cat-PATCH-prodOffering-id__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 68. クエリパラメーター] {#tmf_prod_cat-PATCH-prodOffering-id__table_vxh_xvf_hsb__entry__2}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering_bundledProductOffering-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_id-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_name-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferDefault-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_id-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_externalId-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_name-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-bundledProductOffering_version-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-displayName-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-isBundle-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-isSellable-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_description-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isDefault-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isMandatory-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor_startDateTime-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_value-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_validFor-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_validFor_startDateTime-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_valueType-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isDefault-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isMandatory-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_value-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic_name-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-productOfferingCharacteristic_valueType-entry}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-status-entry} | 名前 | 説明 | |-|-| | バンドルされたグループ製品オファリング | 製品オファリングの子グループ。これらは階層的なサブグループ化を示しています。 データタイプ：オブジェクトのアレイ "bundledGroupProductOffering": [ { "bundledGroupProductOfferingOption": {Object}, "bundledProductOffering": [Array],     "id": "String",     "name": "String" } ] | | bundledGroupProductOffering。bundledGroupProductOfferingOption | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限と上限を指定する数値の範囲。 データタイプ: オブジェクト "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferLowerLimit | 関連するバンドル製品オファリングの一部として調達できる製品オファリングの下限。 データタイプ：文字列 | | bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferUpperLimit | 関連するバンドル製品オファリングの一部として調達できる製品オファリングの上限。 データタイプ：文字列 | | bundledGroupProductOffering。bundledProductOffering | バンドルに関連付けられた製品オファリングの子グループ。以下で指定する bundledProductOffering と同じ形式です。 データタイプ：オブジェクトのアレイ | | bundledGroupProductOffering。身分証明書 | バンドルされたグループレコードのSys_id。親製品オファリングまたはグループに複数のグループが含まれている場合に便利です。 データタイプ：文字列 テーブル:製品オファリングの関係グループ \[sn_prd_pm_product_offering_relationship_group\] | | bundledGroupProductOffering。名前 | 子製品オファリングのグループの名前。 データタイプ：文字列 | | バンドルされた製品オファリング | 製品オファリングバンドルに含まれる製品オファリングのリスト。製品オファリングバンドルは、含まれている製品オファリングのすべての属性を継承します。 データタイプ：オブジェクトのアレイ "bundledProductOffering": [ { "bundledProductOfferingOption": {Object},     "externalId": "String",     "id": "String",     "name": "String",     "version": Number } ] | | bundledProductOffering。bundledProductOfferingOption | 製品オファリングのデフォルト数や製品オファリングの上下の調達制約などの製品バンドルオプション。 データタイプ: オブジェクト "bundledProductOfferingOption": { "numberRelOfferDefault": "String", "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferDefault | 関連するバンドル製品オファリングの一部として調達する必要がある製品オファリングのデフォルト数。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferLowerLimit | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferUpperLimit | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の上限。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。身分証明書 | バンドルされた製品オファリングの Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] | | bundledProductOffering。externalId | 製品オファリング関係の外部 ID。 製品オファリングの関係の詳細については、「 [Create product offering relationships](https://www.servicenow.com/docs/access?context=som-product-config-offering-relationships&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 データタイプ：文字列 | | bundledProductOffering。名前 | 製品オファリングバンドルの名前。 データタイプ：文字列 | | bundledProductOffering。バージョン | 製品オファリングのカタログバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | | カテゴリ | 製品が属するカテゴリのリスト。 データタイプ：オブジェクトのアレイ "category:" [ { "id": "String", "name": "String" } ] テーブル:カテゴリ \[sc_category\] | | category.id | category パラメーターを使用する場合は必須です。カテゴリの ID。 データタイプ：文字列 テーブル:カテゴリ \[sc_category\] | | category.name | カテゴリの名前。 データタイプ：文字列 デフォルト：空白の文字列 | | チャネル | 必須です。製品オファリングの販売に使用するチャネル。 データタイプ：オブジェクトのアレイ "channel:" [ { "description": "String", "id": "String", "name": "String" } ] | | channel.description | チャネルの説明。 データタイプ：文字列 デフォルト：空白の文字列 | | channel.id | 必須です。チャネルのSys_id。 データタイプ：文字列 テーブル:流通チャネル \[sn_prd_pm_distribution_channel\] | | channel.name | チャネルの名前。 データタイプ：文字列 デフォルト：空白の文字列 | | description | 必須です。製品オファリングの説明。 データタイプ：文字列 | | 外部システム | `TMF620` が追加された製品オファリングの外部システム。 たとえば、外部システムが ABC の場合、値は `ABC-TMF620` です。 データタイプ:文字列 | | displayName | 製品オファリングの表示名。 データタイプ：文字列 | | externalId | 製品オファリングの外部 ID。複数のバージョンが公開されている場合は、その中で最も高い公開バージョンを返します。バージョンが公開されていない場合は、ステータスに関係なく最も高いバージョンを返します。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、external_idフィールド | | ID | 必須です。製品オファリングの初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、initial_versionフィールドまたはexternal_idフィールド | | internalId | 製品オファリングレコードの Sys_id ID または内部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、initial_versionフィールド | | internalVersion | 製品オファリングのバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのバージョンフィールド。 | | バンドル | 製品オファリングがバンドルであるかどうかを示すフラグ。 可能な値： * true:製品オファリングはバンドルです。 * false:単一の製品オファリング。 データタイプ：ブーリアン デフォルト値：false | | 販売可能 | 関連付けられた製品オファリングを単独で販売できるか、または製品オファリングバンドルの一部にする必要があるかを示すフラグ。 可能な値： * true:別売りです。 * false:バンドルの一部としてのみ販売されます。 データタイプ：ブーリアン デフォルト値：false | | 前回の更新 | 製品オファリングが最後に更新された日付。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS デフォルト：空白の文字列 | | ライフサイクルステータス | 製品オファリングの現在のライフサイクルステータス。 可能な値： * アクティブ * 非アクティブ * ドラフト データタイプ：文字列 | | name | 必須です。製品オファリングの名前。 データタイプ：文字列 | | prodSpecCharValueUse | 製品オファリング特性。 データタイプ：オブジェクトのアレイ "prodSpecCharValueUse": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | prodSpecCharValueUse。形容 | 特性の説明。 データタイプ：文字列 | | prodSpecCharValueUse.name | 必須。 特性の名前。 データタイプ：文字列 | | prodSpecCharValueUse。productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | prodSpecCharValueUse。productSpecCharacteristicValue。isDefault | 関連する特性値が特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値。 * false:デフォルト値ではありません。 デフォルト値：false | | prodSpecCharValueUse。productSpecCharacteristicValue。必須か | 関連する特性値が特性の必須値であるかどうかを示すフラグ。 可能な値： * true:必須の値。 * false:必須の値ではありません。 デフォルト値：false | | prodSpecCharValueUse。productSpecCharacteristicValue。validFor | 特性が有効になった日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse。productSpecCharacteristicValue。validFor。startDateTime | 特性値が有効になる開始日時。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse。productSpecCharacteristicValue。価値 | 特性の値。 データタイプ：文字列 | | prodSpecCharValueUse。validFor | 特性が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse。validFor。startDateTime | 特性の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse。値タイプ | prodSpecCharValueUse.productSpecCharacteristicValue.valueパラメーターのデータタイプ。 可能な値： * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line Test * チェックボックス * 選択肢 * 日付、住所 * メール * 整数、日付/時刻 * オブジェクト * 1 行テキスト * はい/いいえ {#tmf_prod_cat-PATCH-prodOffering-id__ul_fhv_2jw_xfc} データタイプ：文字列 | | 製品特性 | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] | | productCharacteristic.name | 特性の名前。 データタイプ：文字列 デフォルト：空白の文字列 | | productCharacteristic.value | 特性の値。 データタイプ：文字列 デフォルト：空白の文字列 | | 製品オファリング特性 | 製品オファリングの特徴的な品質または特徴的な機能。特性は、モバイル計画ランクなど、設計時 (カタログオーサリング) に固定された不連続値を取ることができます。これらの特性は、通常、在庫レベルでは変更できません。 製品オファリング特性の詳細については、「 [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 データタイプ：オブジェクトのアレイ productOfferingCharacteristic": [  { "characteristicValueSpecification": [Array], "name": "String", "valueType": "String" } ] | | productOfferingCharacteristic。characteristicValueSpecification | 製品オファリング特性に関連付けられた特性値のリスト。 データタイプ：オブジェクトのアレイ "characteristicValueSpecification": [  { "isDefault": Boolean, "isMandatory": Boolean, "value": "String" }  ] | | productOfferingCharacteristic。characteristicValueSpecificationです。isDefault | 関連する特性値が関連する特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値です。 * false:デフォルト値ではありません。 データタイプ：ブーリアン デフォルト値：false | | productOfferingCharacteristic。characteristicValueSpecificationです。必須か | 関連する特性値が関連する特性に必須かどうかを示すフラグ。 可能な値： * true:必須です。 * false:必須ではありません。 データタイプ：ブーリアン デフォルト値：false | | productOfferingCharacteristic。characteristicValueSpecificationです。価値 | 関連する製品仕様特性に割り当てられた番号またはテキスト。 たとえば、次のようになります。 "characteristicValueSpecification": [ { "value": "choice 1" }, { "value": "choice 2" } ] データタイプ：文字列 | | productOfferingCharacteristic。名前 | 関連付けられた製品オファリング特性の名前。 データタイプ：文字列 | | productOfferingCharacteristic。値タイプ | productOfferingCharacteristic.characteristicValueSpecification.valueパラメーターのデータタイプ。 可能な値： * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line Test * チェックボックス * 選択肢 * 日付、住所 * メール * 整数、日付/時刻 * オブジェクト * 1 行テキスト * はい/いいえ {#tmf_prod_cat-PATCH-prodOffering-id__ul_jpt_fjw_xfc} データタイプ：文字列 | | 製品オファリング価格 | 製品オファリングの価格情報。 データタイプ：オブジェクトのアレイ "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 回限り) * 繰り返し {#tmf_prod_cat-PATCH-prodOffering-id__ul_g3z_bcj_4bc} データタイプ：文字列 | | productOfferingTerm | 製品オファリング 有効な契約期間。 データタイプ：文字列 デフォルト：空白の文字列 | | 製品仕様 | 必須です。製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productSpecification.id | 必須。製品仕様の Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] のsys_idフィールドまたはexternal_idフィールド | | productSpecificationです。内部 ID | 製品仕様レコードの Sys_id ID または内部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[initial_version\] フィールド。 | | productSpecificationです。内部バージョン | 製品仕様のバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのバージョンフィールド。 | | productSpecificationです。名前 | 製品仕様の名前。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの名前フィールド。 | | productSpecificationです。バージョン | 製品仕様の外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | | ステータス | 製品オファリングのステータス。 可能な値： * ドラフト * 公開済み データタイプ：文字列 | | validFor | 必須です。製品オファリングが有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor.endDateTime | 必須です。製品オファリングの終了日時。 データタイプ：文字列 形式：YYYY-MM-DD | | validFor.startDateTime | 必須です。製品オファリングの開始日時。 データタイプ：文字列 形式：YYYY-MM-DD | | バージョン | 製品オファリングの外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | [表 : 69. 要求本文のパラメーター] {#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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_cat-PATCH-prodOffering-id__entry__162}{#tmf_prod_cat-PATCH-prodOffering-id__accept-JSON-only-entry-RESTAPI}{#tmf_prod_cat-PATCH-prodOffering-id__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 70. 要求ヘッダー] {#tmf_prod_cat-PATCH-prodOffering-id__entry__168}{#tmf_prod_cat-PATCH-prodOffering-id__d3014e217} | ヘッダー | 説明 | |-|-| | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 71. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#tmf_prod_cat-PATCH-prodOffering-id__entry__172}{#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 | 見つかりません。要求されたアイテムが見つかりませんでした。 | [表 : 72. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#tmf_prod_cat-PATCH-prodOffering-id__table_bts_ybj_4bc__entry__2}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e285}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e298}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e311}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e322}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e333}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e387}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e400}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e425}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e438}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e451}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e464}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e477}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e505}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e518}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e529}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e542}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e619}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e642}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e692}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e705}{#tmf_prod_cat-PATCH-prodOffering-id__prodCat-offering-prodSpecCharValueUse_name-entry}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e730}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e746}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e767}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e789}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e802}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e815}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e829}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e842}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e855}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e917}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e935}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e948}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e971}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e994}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e1009}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e1021}{#tmf_prod_cat-PATCH-prodOffering-id__d3125e1161} | 名前 | 説明 | |-|-| | バンドルされたグループ製品オファリング | 製品オファリングの子グループ。これらは階層的なサブグループ化を示しています。 データタイプ：オブジェクトのアレイ "bundledGroupProductOffering": [ { "bundledGroupProductOfferingOption": {Object}, "bundledProductOffering": [Array],     "id": "String",     "name": "String" } ] | | bundledGroupProductOffering。bundledGroupProductOfferingOption | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限と上限を指定する数値の範囲。 データタイプ: オブジェクト "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferLowerLimit | 関連するバンドル製品オファリングの一部として調達できる製品オファリングの下限。 データタイプ：文字列 | | bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferUpperLimit | 関連するバンドル製品オファリングの一部として調達できる製品オファリングの上限。 データタイプ：文字列 | | bundledGroupProductOffering。bundledProductOffering | バンドルに関連付けられた製品オファリングの子グループ。以下で指定する bundledProductOffering と同じ形式です。 データタイプ：オブジェクトのアレイ | | bundledGroupProductOffering。身分証明書 | バンドルされたグループレコードのSys_id。親製品オファリングまたはグループに複数のグループが含まれている場合に便利です。 データタイプ：文字列 テーブル:製品オファリングの関係グループ \[sn_prd_pm_product_offering_relationship_group\] | | bundledGroupProductOffering。名前 | 子製品オファリングのグループの名前。 データタイプ：文字列 | | バンドルされた製品オファリング | 製品オファリングバンドルに含まれる製品オファリングのリスト。製品オファリングバンドルは、含まれている製品オファリングのすべての属性を継承します。 データタイプ：オブジェクトのアレイ "bundledProductOffering": [ { "bundledProductOfferingOption": {Object},     "externalId": "String",     "id": "String",     "name": "String",     "version": Number } ] | | bundledProductOffering。bundledProductOfferingOption | 製品オファリングのデフォルト数や製品オファリングの上下の調達制約などの製品バンドルオプション。 データタイプ: オブジェクト "bundledProductOfferingOption": { "numberRelOfferDefault": "String", "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferDefault | 関連するバンドル製品オファリングの一部として調達する必要がある製品オファリングのデフォルト数。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferLowerLimit | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferUpperLimit | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の上限。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。externalId | 製品オファリング関係の外部 ID。 製品オファリングの関係の詳細については、「 [Create product offering relationships](https://www.servicenow.com/docs/access?context=som-product-config-offering-relationships&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 データタイプ：文字列 | | bundledProductOffering。身分証明書 | バンドルされた製品オファリングの Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] | | bundledProductOffering。名前 | 製品オファリングバンドルの名前。 データタイプ：文字列 | | bundledProductOffering。バージョン | 製品オファリングのカタログバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | | カテゴリ | 製品が属するカテゴリのリスト。 データタイプ：オブジェクトのアレイ "category:" [ { "id": "String", "name": "String" } ] | | category.id | カテゴリの ID。 データタイプ：文字列 | | category.name | カテゴリの名前。 データタイプ：文字列 | | チャネル | 製品オファリングの販売に使用するチャネル。 データタイプ：オブジェクトのアレイ "channel:" [ { "description": "String", "id": "String", "name": "String" } ] | | channel.description | チャネルの説明。 データタイプ：文字列 | | channel.id | チャネルのSys_id。 データタイプ：文字列 テーブル:流通チャネル \[sn_prd_pm_distribution_channel\] | | channel.name | チャネルの名前。 データタイプ：文字列 | | description | 製品オファリングの説明。 データタイプ：文字列 | | displayName | 製品オファリングの表示名。 データタイプ：文字列 | | externalId | 製品オファリングの外部 ID。複数のバージョンが公開されている場合は、その中で最も高い公開バージョンを返します。バージョンが公開されていない場合は、ステータスに関係なく最も高いバージョンを返します。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、external_idフィールド | | 外部システム | `TMF620` が追加された製品オファリングの外部システム。 たとえば、外部システムが ABC の場合、値は `ABC-TMF620` です。 データタイプ:文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 | | ID | 必須です。製品オファリングの初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、initial_versionフィールドまたはexternal_idフィールド | | internalId | 製品オファリングレコードの Sys_id ID または内部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、initial_versionフィールド | | internalVersion | 製品オファリングのバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのバージョンフィールド。 | | バンドル | 製品オファリングがバンドルであるかどうかを示すフラグ。 可能な値： * true:製品オファリングはバンドルです。 * false:単一の製品オファリング。 データタイプ：ブーリアン デフォルト値：false | | 販売可能 | 関連付けられた製品オファリングを単独で販売できるか、または製品オファリングバンドルの一部にする必要があるかを示すフラグ。 可能な値： * true:別売りです。 * false:バンドルの一部としてのみ販売されます。 データタイプ：ブーリアン デフォルト値：false | | 前回の更新 | 製品オファリングが最後に更新された日付。 データタイプ：文字列 | | リフトサイクルステータス | 現在のライフサイクルステータス。指定できる値: * 有効 * ドラフト * 非アクティブ {#tmf_prod_cat-PATCH-prodOffering-id__ul_lj5_gg4_4bc} データタイプ：文字列 デフォルト：空白の文字列 | | name | 製品オファリングの名前。 データタイプ：文字列 | | prodSpecCharValueUse | 製品オファリング特性。 データタイプ：オブジェクトのアレイ "prodSpecCharValueUse": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | prodSpecCharValueUse。形容 | 特性の説明。 データタイプ：文字列 | | prodSpecCharValueUse。名前 | 特性の名前。 データタイプ：文字列 | | prodSpecCharValueUse。productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | prodSpecCharValueUse。productSpecCharacteristicValue。isDefault | 関連する特性値が特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値。 * false:デフォルト値ではありません。 デフォルト値：false | | prodSpecCharValueUse。productSpecCharacteristicValue。必須か | 関連する特性値が特性の必須値であるかどうかを示すフラグ。 可能な値： * true:必須の値。 * false:必須の値ではありません。 デフォルト値：false | | prodSpecCharValueUse。productSpecCharacteristicValue。validFor | 特性が有効になった日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse。productSpecCharacteristicValue。validFor。startDateTime | 特性値が有効になる開始日時。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse。productSpecCharacteristicValue。価値 | 特性の値。 データタイプ：文字列 | | prodSpecCharValueUse。validFor | 特性が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse。validFor。startDateTime | 特性の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse。値タイプ | prodSpecCharValueUse.productSpecCharacteristicValue.valueパラメーターのデータタイプ。 可能な値： * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line Test * チェックボックス * 選択肢 * 日付、住所 * メール * 整数、日付/時刻 * オブジェクト * 1 行テキスト * はい/いいえ {#tmf_prod_cat-PATCH-prodOffering-id__d3125e861} データタイプ：文字列 | | 製品特性 | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] | | productCharacteristicです。名前 | 特性の名前。 データタイプ：文字列 | | productCharacteristicです。価値 | 特性の値。 データタイプ：文字列 | | 製品オファリング特性 | 製品オファリングの特徴的な品質または特徴的な機能。特性は、モバイル計画ランクなど、設計時 (カタログオーサリング) に固定された不連続値を取ることができます。これらの特性は、通常、在庫レベルでは変更できません。 製品オファリング特性の詳細については、「 [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 データタイプ：オブジェクトのアレイ productOfferingCharacteristic": [  { "characteristicValueSpecification": [Array], "name": "String", "valueType": "String" } ] | | productOfferingCharacteristic。characteristicValueSpecification | 製品オファリング特性に関連付けられた特性値のリスト。 データタイプ：オブジェクトのアレイ "characteristicValueSpecification": [  { "isDefault": Boolean, "isMandatory": Boolean, "value": "String" }  ] | | productOfferingCharacteristic。characteristicValueSpecificationです。isDefault | 関連する特性値が関連する特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値です。 * false:デフォルト値ではありません。 データタイプ：ブーリアン デフォルト値：false | | productOfferingCharacteristic。characteristicValueSpecificationです。必須か | 関連する特性値が関連する特性に必須かどうかを示すフラグ。 可能な値： * true:必須です。 * false:必須ではありません。 データタイプ：ブーリアン デフォルト値：false | | productOfferingCharacteristic。characteristicValueSpecificationです。価値 | 関連する製品仕様特性に割り当てられた番号またはテキスト。 たとえば、次のようになります。 "characteristicValueSpecification": [ { "value": "choice 1" }, { "value": "choice 2" } ] データタイプ：文字列 | | productOfferingCharacteristic。名前 | 関連付けられた製品オファリング特性の名前。 データタイプ：文字列 | | productOfferingCharacteristic。値タイプ | productOfferingCharacteristic.characteristicValueSpecification.valueパラメーターのデータタイプ。 可能な値： * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line Test * チェックボックス * 選択肢 * 日付、住所 * メール * 整数、日付/時刻 * オブジェクト * 1 行テキスト * はい/いいえ {#tmf_prod_cat-PATCH-prodOffering-id__d3125e1027} データタイプ：文字列 | | 製品オファリング価格 | 製品オファリングの価格情報。 データタイプ：オブジェクトのアレイ "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] | | productOfferingPrice です。価格 | 製品オファリングの価格情報。 データタイプ: オブジェクト "price": { "taxIncludedAmount": {Object} } | | productOfferingPrice です。価格。税込み金額 | 製品オファリングの価格情報。 データタイプ: オブジェクト "taxIncludedAmount": { "unit": "String", "value": "String" } | | productOfferingPrice です。価格。taxIncludedAmount.unit | 製品オファリング価格の通貨コード。 データタイプ：文字列 | | productOfferingPrice です。価格。taxIncludedAmount です。価値 | 税込みの製品オファリングの価格。 データタイプ：文字列 | | productOfferingPrice です。価格タイプ | 製品オファリング価格タイプ (1 回払いまたは繰り返し支払い)。 可能な値： * 非繰り返し (1 回限り) * 繰り返し {#tmf_prod_cat-PATCH-prodOffering-id__ul_cts_ybj_4bc} データタイプ：文字列 | | productOfferingTerm | 製品オファリングの有効な契約期間。 データタイプ：文字列 | | 製品仕様 | 製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "status": "String", "sys_id": "String", "version": "String" } | | productSpecificationです。身分証明書 | 製品仕様レコードのSys_id。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[initial_version\] フィールド。 | | productSpecificationです。内部 ID | 製品仕様レコードの Sys_id ID または内部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[initial_version\] フィールド。 | | productSpecificationです。内部バージョン | 製品仕様のバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのバージョンフィールド。 | | productSpecificationです。地位 | 公開済みやドラフトなど、製品仕様のステータス。 データタイプ：文字列 | | productSpecificationです。sys_id | 製品仕様の sys_id。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] | | productSpecificationです。バージョン | 製品仕様の外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | | ステータス | 製品オファリングのステータス。 可能な値： * ドラフト * 公開済み データタイプ：文字列 | | validFor | 製品オファリングが有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor。endDateTime | 製品オファリングの終了日。 データタイプ：文字列 | | validFor。startDateTime | 製品オファリングの開始日。 データタイプ：文字列 | | バージョン | 製品オファリングの外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | [ ] {#tmf_prod_cat-PATCH-prodOffering-id__table_bts_ybj_4bc} 次の例では、要求本文で提供された情報を使用して、sys_id 313b917843235210a82ed6085bb8f2c7 で製品オファリングを更新します。 curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOffering/313b917843235210a82ed6085bb8f2c7" \ --request PATCH\ --header "Accept:application/json" \ --user 'username':'password' --data '{ "id": "313b917843235210a82ed6085bb8f2c7", "name": "Internet bundle", "displayName": "Internet bundle", "description": "Internet bundle", "externalSystem": "Salesforce-TMF620", "isSellable": false, "lifecycleStatus": "Draft", "isBundle": true, "lastUpdate": "2025-02-05 06:39:45", "version": "", "internalVersion": "1", "internalId": "313b917843235210a82ed6085bb8f2c7", "validFor": { "startDateTime": "2028-12-15", "endDateTime": "2034-01-14" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } } ], "productOfferingCharacteristic": [ { "name": "Firewall Security", "valueType": "choice", "characteristicValueSpecification": [ { "value": "Premium", "isMandatory": false, "isDefault": true } ] }, { "name": "Connectivity need", "valueType": "choice", "characteristicValueSpecification": [ { "value": "When in use", "isMandatory": false, "isDefault": false } ] } ], "bundledProductOffering": [ { "id": "0f61dd9fd0a63110f8770dbf976be168", "name": "Solana Sports streaming channel", "version": "1", "externalId": "EXT-123", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOffering": [ { "id": "063b957843235210a82ed6085bb8f205", "name": "Streaming Channel", "bundledProductOffering": [ { "id": "62619d9fd0a63110f8770dbf976be180", "name": "Solana Movie streaming channel", "version": "1", "externalId": "EXT-123", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6" }, "prodSpecCharValueUse": [ { "name": "Tenancy", "description": "Tenancy", "valueType": "choice", "validFor": { "startDatetime": "2024-12-18 21:04:24" }, "productSpecCharacteristicValue": [ { "value": "Premium (>50 sites)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } }, { "value": "Base (10 site)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5" } } ], "channel": [ { "id": "58ad5522c3702010df4773ce3640ddb2", "name": "Agent Assist" } ], "category": [ { "id": "13e305a143b631105029d1529ab8f267", "name": "SD-WAN_all_offers" } ], "status": "draft" }' 応答本文： { "id": "313b917843235210a82ed6085bb8f2c7", "href": "/api/sn_tmf_api/catalogmanagement/productOffering/313b917843235210a82ed6085bb8f2c7", "externalSystem": "Salesforce-TMF620" "name": "Internet", "displayName": "Internet", "description": "Internet bundle", "isSellable": false, "lifecycleStatus": "Draft", "isBundle": true, "lastUpdate": "2025-02-05 06:39:45", "version": "", "internalVersion": "1", "internalId": "313b917843235210a82ed6085bb8f2c7", "validFor": { "startDateTime": "2028-12-15", "endDateTime": "2034-01-14" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } } ], "productOfferingCharacteristic": [ { "name": "Firewall Security", "valueType": "choice", "characteristicValueSpecification": [ { "value": "Premium", "isMandatory": false, "isDefault": true } ] }, { "name": "Connectivity need", "valueType": "choice", "characteristicValueSpecification": [ { "value": "When in use", "isMandatory": false, "isDefault": false } ] } ], "bundledProductOffering": [ { "id": "0f61dd9fd0a63110f8770dbf976be168", "name": "Solana Sports streaming channel", "version": "1", "externalId": "EXT-123", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } }, { "id": "0f61dd9fd0a63110f8770dbf976be16c", "name": "Solana TV shows streaming channel", "version": "1", "externalId": "EXT-456", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOffering": [ { "id": "063b957843235210a82ed6085bb8f205", "name": "Streaming Channel", "bundledProductOffering": [ { "name": "Internet", "version": "1", "externalId": "EXT-678", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "3" } }, { "id": "313b917843235210a82ed6085bb8f2c7", "name": "Streaming Channel", "bundledProductOffering": [ { "id": "1161a4f8436b1210a82ed6085bb8f216", "name": "Internet", "version": "1", "externalId": "EXT-910", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6" }, "prodSpecCharValueUse": [ { "name": "Tenancy", "description": "Tenancy", "valueType": "choice", "validFor": { "startDatetime": "2024-12-18 21:04:24" }, "productSpecCharacteristicValue": [ { "value": "Premium (>50 sites)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } }, { "value": "Advance (50 site)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } }, { "value": "Base (10 site)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5" } } ], "channel": [ { "id": "58ad5522c3702010df4773ce3640ddb2", "name": "Agent Assist" } ], "category": [ { "id": "13e305a143b631105029d1529ab8f267", "name": "SD-WAN_all_offers" } ], "status": "draft" } ## 製品カタログオープン API - PATCH /sn_tmf_api/catalogmanagement/productOfferingPrice/{id} {#ariaid-title14} 価格明細 \[sn_csm_pricing_price_list_line\] テーブルの指定されたsys_idで価格明細レコードを更新します。 ### URL 形式 デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice/{id} ### サポートされている要求パラメーター {#tmf_prod_order-PATCH-prodoffprce-id__entry__2} | 名前 | 説明 | |-|-| | ID | 必須です。取得する価格明細のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | [表 : 73. パスパラメーター] {#tmf_prod_order-PATCH-prodoffprce-id__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 74. クエリパラメーター] {#tmf_prod_order-PATCH-prodoffprce-id__id_abw_fvw_22c__entry__2} | 名前 | 説明 | |-|-| | @type | 必須です。価格明細のタイプ。常に `ProductOfferingPrice` の値です。 データタイプ：文字列 | | externalId | 価格明細の外部 ID。 データタイプ：文字列 | | バンドル | 価格明細が単一の製品の一部であるか、製品のバンドルの一部であるかを示すフラグ。 有効な値： * true:価格明細はバンドルの一部です。 * false:価格明細はバンドルの一部ではありません。 データタイプ：ブーリアン デフォルト値：false | | 前回の更新 | 必須です。価格行が最後に更新された日付。 形式：YYYY-MM-DD データタイプ：文字列 | | ライフサイクルステータス | 必須です。製品リスト明細の現在のライフサイクルステータス。 有効な値： * アクティブ * ドラフト * inactive データタイプ：文字列 デフォルト:ドラフト | | name | 必須です。価格明細に付ける名前。 データタイプ：文字列 | | 価格 | 必須です。価格明細の表示価格の詳細。 データタイプ: オブジェクト "price": { "unit": "String", "value": "String" } | | price.unit | 必須です。価格明細の通貨コード。たとえば、 `USD` や `EUR` などです。 テーブル:通貨 \[fx_currency\] テーブル。 データタイプ：文字列 | | price.value | 必須です。価格の値。 データタイプ:文字列 (数値で表されます。例:「 `800」)`。 | | priceList | 必須です。価格明細に関連付けられた価格リスト情報。 データタイプ: オブジェクト "priceList": { "id": "String", "name": "String", "@type": "String" } | | priceList.id | 必須です。価格明細のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | priceList.name | 価格明細の名前。 データタイプ：文字列 | | priceList.@type | 価格明細のタイプ。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。値は常に `priceList` です。 データタイプ：文字列 | | 価格タイプ | 必須です。製品オファリングの価格設定方法で価格明細をフィルタリングします。 有効な値： * recurring:指定された頻度で繰り返し価格設定金額を請求します。頻度は recurringChargePeriodType パラメーターで設定します。 * one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金と料金をサポートします。 データタイプ：文字列 デフォルト:繰り返し | | productOffering | 必須です。価格明細の製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } | | productOffering です。身分証明書 | 必須。製品オファリングのSys_id。 テーブル:製品オファリング \[sn_prd_pm_product_offering\] データタイプ：文字列 | | productOffering です。内部バージョン | 製品オファリングの内部バージョン番号。 データタイプ:文字列 (数値で表されます。たとえば `、「1」`など)。 | | productOffering です。名前 | 製品オファリングの名前。 データタイプ：文字列 | | recurringChargePeriodType | priceTypeを繰り返す場合は必須です。製品オファリングの作成時に選択されたコミットメント期間。 有効な値： * 年次 * 月次 データタイプ：文字列 | | 測定単位 | 必須です。価格明細に関連付けられた測定単位に関する詳細。 データタイプ: オブジェクト "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } | | unitOfMeasure です。量 | 測定単位の金額。 データタイプ：数値 | | unitOfMeasure です。身分証明書 | 必須。価格ラインリストテーブルの測定単位のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | unitOfMeasure です。単位 | 価格明細に関連付けられた測定単位のタイプ。たとえば、`各または``バンドル`です。 データタイプ：文字列 | | validFor | 必須です。価格明細が有効な期間。 データタイプ: オブジェクト "validFor": { "endDate": "String", "startDate": "String" } | | validFor.endDate | 価格明細が有効な終了日。 データタイプ:文字列 (glide_date_time) | | validFor.endDateTime | 価格明細が有効な終了日時。 形式:YYYY-MM-DD HH:mm:ss データタイプ:文字列 (glide_date) | | validFor.startDate | 価格明細が有効な開始日。 データタイプ:文字列 (glide_date_time) | | validFor.startDateTime | 価格明細が有効な開始日時。 形式:YYYY-MM-DD HH:mm:ss データタイプ:文字列 (glide_date) | [表 : 75. 要求本文パラメーター (XML または JSON)] {#tmf_prod_order-PATCH-prodoffprce-id__id_abw_fvw_22c} ### ヘッダー {#tmf_prod_order-PATCH-prodoffprce-id__section_q1h_tvw_22c} 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_order-PATCH-prodoffprce-id__table_r1h_tvw_22c__entry__2}{#tmf_prod_order-PATCH-prodoffprce-id__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 76. 要求ヘッダー] {#tmf_prod_order-PATCH-prodoffprce-id__table_r1h_tvw_22c} {#tmf_prod_order-PATCH-prodoffprce-id__table_s1h_tvw_22c__entry__2} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 77. 応答ヘッダー] {#tmf_prod_order-PATCH-prodoffprce-id__table_s1h_tvw_22c} ### ステータスコード {#tmf_prod_order-PATCH-prodoffprce-id__section_t1h_tvw_22c} この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#tmf_prod_order-PATCH-prodoffprce-id__table_onp_pnw_22c__entry__2}{#tmf_prod_order-PATCH-prodoffprce-id__entry-200-status-code}{#tmf_prod_order-PATCH-prodoffprce-id__entry-404-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。 考えられる理由: * 無効なパスパラメーター * 無効な URI {#tmf_prod_order-PATCH-prodoffprce-id__ul_qkg_2rv_22c} | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | [表 : 78. ステータスコード] {#tmf_prod_order-PATCH-prodoffprce-id__table_onp_pnw_22c} ### 応答本文のパラメーター (JSON または XML) {#tmf_prod_order-PATCH-prodoffprce-id__section_q3r_rvw_22c} {#tmf_prod_order-PATCH-prodoffprce-id__table_r3r_rvw_22c__entry__2} | 名前 | 説明 | |-|-| | ID | 価格明細のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | href | インスタンス内の価格明細レコードへの URL。 データタイプ：文字列 | | 前回の更新 | 価格明細が最後に更新された日時。 形式:YYYY-MM-DD HH:mm:ss データタイプ：文字列 | | validFor | 価格明細が有効な期間。 データタイプ: オブジェクト "validFor": { "endDate": "String", "startDate": "String" } | | validFor.endDate | 価格明細が有効な終了日時。 データタイプ:文字列 (glide_date_time) | | validFor.startDate | 価格明細が有効な開始日時。 データタイプ:文字列 (glide_date_time) | | バンドル | 価格明細が単一の製品の一部であるか、製品のバンドルの一部であるかを示すフラグ。 有効な値： * true:価格明細はバンドルの一部です。 * false:価格明細はバンドルの一部ではありません。 データタイプ：ブーリアン | | ライフサイクルステータス | 価格明細の現在のライフサイクル状況。 有効な値： * 有効 * ドラフト * 非アクティブ データタイプ：文字列 | | productOffering | 価格明細に関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } | | productOffering.id | 製品オファリングのSys_id。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 | | productOffering です。内部バージョン | 製品オファリングの内部バージョン番号。たとえば、 `PRDOF01024` などです。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 | | productOffering です。名前 | 製品オファリングの名前。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 | | 価格タイプ | この価格明細に関連付けられている製品オファリングの価格設定方法。 可能な値： * recurring:指定された頻度で繰り返し価格設定金額を請求します。recurringChargePeriodTypeの値は、充電の頻度を示します。 * one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金および料金。 データタイプ：文字列 | | recurringChargePeriodType | この価格明細に関連付けられた製品オファリングの周期性または頻度。繰り返し`に設定されている場合`は頻度タイプpriceType返し、それ以外の場合は空の文字列を返します。 可能な値： * 年次 * 月次 データタイプ：文字列 | | 測定単位 | 価格明細に関連付けられた測定単位に関する詳細。 データタイプ: オブジェクト "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } | | unitOfMeasure.amount | 測定単位の金額。 データタイプ：数値 | | unitOfMeasure.id | 測定単位のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | unitOfMeasure です。単位 | 価格明細に関連付けられた測定単位のタイプ。たとえば、 `年` や `バンドル`などです。 データタイプ：文字列 | | 価格 | 価格明細の表示価格の詳細。 データタイプ: オブジェクト "price": { "units": "String", "value": "String" } | | price.units | 価格の通貨コード。たとえば、 `USD` や `EUR` などです。 テーブル:通貨 \[fx_currency\] データタイプ：文字列 | | price.value | 価格の値。 データタイプ:文字列 (数値で表される) | | priceList | 価格明細に関連付けられた価格リスト情報。 データタイプ: オブジェクト "priceList": { "id": "String", "name": "String", "@type": "String" } | | priceList.id | 価格リスト \[sn_csm_pricing_price_list\] テーブルの価格リストのSys_id。 データタイプ：文字列 | | priceList.name | 価格リストの名前。 データタイプ：文字列 | | priceList.@type | 価格リストのタイプ。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。常に `priceList` の値を持ちます。 データタイプ：文字列 | | @type | 常に `ProductOfferingPrice` の値です。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。 データタイプ：文字列 | | 状況 | この価格明細に関連付けられている価格リストのステータス。 データタイプ：文字列 | | externalId | この価格明細の外部 ID。 データタイプ：文字列 | [ ] {#tmf_prod_order-PATCH-prodoffprce-id__table_r3r_rvw_22c} ### cURL 要求 次の例では、ID が 3ddd0 の製品オファリング価格の日付を更新します...は有効です。 curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOfferingPrice/994d5d364f8b5210f899f61d20ce0b7c" \ --request patch\ --user 'username':'password' --data { "validFor": { "endDateTime": "2024-06-25 15:15:58" } } 応答本文： { "validFor": { "endDateTime": "2024-06-25 15:15:58" }, "id": "994d5d364f8b5210f899f61d20ce0b7c", "name": "new Price list", "lastUpdate": "2025-01-16 00:15:32", "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/994d5d364f8b5210f899f61d20ce0b7c", "lifecycleStatus": "Draft" } ## 製品カタログオープン API - PATCH /sn_tmf_api/catalogmanagement/productSpecification/{id} {#ariaid-title15} 指定された製品仕様を更新します。 ### 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\] | [表 : 79. パスパラメーター] {#tmf_prod_order-PATCH-productSpec-id__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 80. クエリパラメーター] {#tmf_prod_order-PATCH-productSpec-id__entry__10} | 名前 | 説明 | |-|-| | description | 必須です。仕様の説明。 データタイプ：文字列 | | externalId | 必須です。 製品仕様の外部 ID。複数のバージョンが公開されている場合は、その中で最も高い公開バージョンを返します。バージョンが公開されていない場合は、ステータスに関係なく最も高いバージョンを返します。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのexternal_idフィールド内。 | | ID | 製品仕様の Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | internalId | 必須。 製品仕様のSys_idまたは内部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルの initial_version フィールド内。 | | internalVersion | 製品仕様のバージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのバージョンフィールド。 | | バンドル | productSpecificationが単一の製品を表すか、製品のバンドルを表すかを示すフラグ。 有効な値： * true:製品仕様は製品バンドルであり、複数の製品が含まれています。 * false:製品仕様には単一の製品が含まれています。 {#tmf_prod_order-PATCH-productSpec-id__ul_rry_rz4_4bc} データタイプ：ブーリアン デフォルト値：false | | 前回の更新 | 仕様が最後に更新された日付。 データタイプ：文字列 デフォルト：空白の文字列 | | name | 必須です。仕様の名前。 データタイプ：文字列 | | 製品仕様特性 | 仕様特性。 データタイプ：オブジェクトのアレイ "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | productSpecCharacteristicです。形容 | 特性の説明。 データタイプ：文字列 | | productSpecCharacteristicです。名前 | 必須。特性の名前。 データタイプ：文字列 | | productSpecCharacteristicです。productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | productSpecCharacteristicです。productSpecCharacteristicValue。isDefault | 関連する特性値が特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値。 * false:デフォルト値ではありません。 デフォルト値：false | | productSpecCharacteristicです。productSpecCharacteristicValue。必須か | 関連する特性値が特性の必須値であるかどうかを示すフラグ。 可能な値： * true:必須の値。 * false:必須の値ではありません。 デフォルト値：false | | productSpecCharacteristicです。productSpecCharacteristicValue。validFor | 特性が有効になった日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | productSpecCharacteristicです。productSpecCharacteristicValue。validFor。startDateTime | 特性値が有効になる開始日時。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | productSpecCharacteristicです。productSpecCharacteristicValue。価値 | 特性の値。 データタイプ：文字列 | | productSpecCharacteristicです。validFor | 特性が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecCharacteristicです。validFor。endDateTime | 特性の終了日時 形式:YYYY-MM-DD HH:mm:SS。例: `2025-01-31 09:35:43`。 データタイプ：文字列 | | productSpecCharacteristicです。validFor。startDateTime | 特性の開始日時 形式:YYYY-MM-DD HH:mm:SS。例: `2025-01-31 09:35:43`。 データタイプ：文字列 | | productSpecCharacteristicです。値タイプ | 特性の値タイプ (選択肢やメールなど)。複合型または非複合型にすることができます。 データタイプ：文字列 指定できる値: * 日付、住所 * 整数、日付/時刻 * Array.Integer * Array.Single Line Test * 1 行テスト * Array.Object * Array.Date * Array.Decimal * はい/いいえ * オブジェクト * Array.Datetime * チェックボックス * メール * 選択肢 {#tmf_prod_order-PATCH-productSpec-id__ul_khq_trk_tfc} デフォルト値:空の文字列 | | 製品仕様関係 | 仕様と他の製品仕様との関係の詳細。 データタイプ：オブジェクトのアレイ "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": {Object} } ] | | productSpecificationRelationship。身分証明書 | 関連仕様の ID。 データタイプ：文字列 | | productSpecificationRelationship。種類 | productSpecificationRelationship パラメーターを使用する場合は必須です。関係のタイプ。 有効な値： * バンドル * 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 HH:mm:SS。例: `2025-01-31 09:35:43`。 データタイプ：文字列 | | productSpecificationRelationship。validFor。startDateTime | 関係の開始日。 形式:YYYY-MM-DD 00:00:00。例: `2025-01-31 09:35:43`。 データタイプ：文字列 | | リソース仕様 | 必須です。この製品仕様に関連するリソース仕様の詳細。 データタイプ：オブジェクトのアレイ "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | resourceSpecification です。身分証明書 | 必須。リソース仕様の初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | resourceSpecification です。内部 ID | リソース仕様レコードの初期バージョン (sys_id)。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの initial_version フィールド。 | | resourceSpecification です。内部バージョン | リソース仕様のバージョン。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルのバージョンフィールド。 | | resourceSpecification です。名前 | リソース仕様の名前。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] | | resourceSpecification です。バージョン | リソース仕様の外部バージョン。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの external_version フィールド内。 | | サービス仕様 | この製品仕様に関連するサービス仕様のリスト。 データタイプ：オブジェクトのアレイ "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | serviceSpecificationです。身分証明書 | サービス仕様の初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | serviceSpecificationです。内部 ID | サービス仕様の初期バージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルの initial_version フィールド。 | | serviceSpecificationです。内部バージョン | サービス仕様のバージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルのバージョンフィールド。 | | serviceSpecificationです。名前 | サービス仕様の名前。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] | | serviceSpecificationです。バージョン | サービス仕様の外部バージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルの external_version フィールド。 | | 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`。 データタイプ：文字列 | | バージョン | 製品仕様の外部バージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルの external_version フィールド。 | [表 : 81. 要求本文パラメーター (JSON)] ### ヘッダー {#tmf_prod_order-PATCH-productSpec-id__section_rbn_cdj_4bc} 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_order-PATCH-productSpec-id__table_kqy_wgy_fsb__entry__2} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 82. 要求ヘッダー] {#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 のみをサポートします。 | [表 : 83. 応答ヘッダー] {#tmf_prod_order-PATCH-productSpec-id__table_tzy_thy_ksb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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 | 見つかりません。要求されたアイテムが見つかりませんでした。 | [表 : 84. ステータスコード] {#tmf_prod_order-PATCH-productSpec-id__table_nxj_ykz_gsb} ### 応答本文のパラメーター {#tmf_prod_order-PATCH-productSpec-id__table_xj1_jcj_4bc__entry__2} | 名前 | 説明 | |-|-| | description | 仕様の説明。 データタイプ：文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 | | ID | 製品仕様の Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | internalId | 必須。 製品仕様のSys_idまたは内部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルの initial_version フィールド内。 | | internalVersion | 製品仕様のバージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのバージョンフィールド。 | | 前回の更新 | 仕様が最後に更新された日付。 形式:YYYY-MM-DD 00:00:00。 データタイプ：文字列 | | name | 仕様の名前。 データタイプ：文字列 | | 製品仕様特性 | 仕様の特性。 データタイプ：オブジェクトのアレイ "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | productSpecCharacteristicです。形容 | 特性の説明。 データタイプ：文字列 | | productSpecCharacteristicです。名前 | 特性の名前。 データタイプ：文字列 | | productSpecCharacteristicです。productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | productSpecCharacteristicです。productSpecCharacteristicValue。isDefault | 関連する特性値が特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値。 * false:デフォルト値ではありません。 デフォルト値：false | | productSpecCharacteristicです。productSpecCharacteristicValue。必須か | 関連する特性値が特性の必須値であるかどうかを示すフラグ。 可能な値： * true:必須の値。 * false:必須の値ではありません。 デフォルト値：false | | productSpecCharacteristicです。productSpecCharacteristicValue。validFor | 特性が有効になった日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | productSpecCharacteristicです。productSpecCharacteristicValue。validFor。startDateTime | 特性値が有効になる開始日時。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | productSpecCharacteristicです。productSpecCharacteristicValue。価値 | 特性の値。 データタイプ：文字列 | | 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です。値タイプ | 特性の値タイプ (選択肢やメールなど)。複合型または非複合型にすることができます。 データタイプ：文字列 指定できる値: * 日付、住所 * 整数、日付/時刻 * Array.Integer * Array.Single Line Test * 1 行テスト * Array.Object * Array.Date * Array.Decimal * はい/いいえ * オブジェクト * Array.Datetime * チェックボックス * メール * 選択肢 | | 製品仕様関係 | この仕様と他の製品仕様との関係。 データタイプ：オブジェクトのアレイ "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": {Object} } ] | | productSpecificationRelationship。身分証明書 | 関連仕様のSys_id。 データタイプ：文字列 | | productSpecificationRelationship。種類 | 関係のタイプ。 データタイプ：文字列 | | productSpecificationRelationship。validFor | 関係が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecificationRelationship。validFor。endDateTime | 関係の終了日とタイプ。 形式：YYYY-MM-DD データタイプ：文字列 | | productSpecificationRelationship。validFor。startDateTime | 関係の開始日とタイプ。 形式：YYYY-MM-DD データタイプ：文字列 | | リソース仕様 | この製品仕様に関連するリソース仕様のリスト。 データタイプ：オブジェクトのアレイ "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | resourceSpecification です。身分証明書 | リソース仕様の Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | resourceSpecification です。内部 ID | リソース仕様レコードの初期バージョン (sys_id)。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの initial_version フィールド。 | | resourceSpecification です。内部バージョン | リソース仕様のバージョン。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルのバージョンフィールド。 | | resourceSpecification です。名前 | リソース仕様の名前。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] | | resourceSpecification です。バージョン | リソース仕様の外部バージョン。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの external_version フィールド内。 | | サービス仕様 | この製品仕様に関連するサービス仕様のリスト。 データタイプ：オブジェクトのアレイ "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | serviceSpecificationです。身分証明書 | サービス仕様の初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | serviceSpecificationです。内部 ID | サービス仕様の初期バージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルの initial_version フィールド。 | | serviceSpecificationです。内部バージョン | サービス仕様のバージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルのバージョンフィールド。 | | serviceSpecificationです。名前 | サービス仕様の名前。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] | | serviceSpecificationです。バージョン | サービス仕様の外部バージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルの external_version フィールド。 | | validFor | 仕様が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor。endDateTime | 仕様の終了日時。 形式:YYYY-MM-DD HH:mm:SS。 データタイプ：文字列 | | validFor。startDateTime | 仕様の開始日時。 形式:YYYY-MM-DD HH:mm:SS。 データタイプ：文字列 | | バージョン | 製品仕様の外部バージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルの external_version フィールド。 | [ ] {#tmf_prod_order-PATCH-productSpec-id__table_xj1_jcj_4bc} 次の例では、製品仕様 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": "cfe5ef6a53702010cd6dddeeff7b12f6", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "displayName": "SD-WAN Service Package v3", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "description": "SD WAN Service Package", "lastUpdate": "2027-10-11 06:58:12", "isBundle": true, "validFor": { "startDateTime": "2029-02-05", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [ { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "type": "Service", "validFor": { "startDateTime": "2025-01-24", "endDateTime": "" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "1", "numberSpecRelUpperLimit": "1" } }, { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "", "internalVersion": "2", "internalId": "39b627aa53702010cd6dddeeff7b1202", "type": "Service", "validFor": { "startDateTime": "2026-06-05", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "2", "numberSpecRelUpperLimit": "4" } }, { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "", "internalVersion": "2", "internalId": "a6514bd3534560102f18ddeeff7b1247", "type": "Service", "validFor": { "startDateTime": "2026-06-03", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "4", "numberSpecRelUpperLimit": "20" } } ], "resourceSpecification": [], "productSpecCharacteristic": [ { "productSpecCharacteristicValue": [ { "value": "1", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.25", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.01", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.5", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } } ], "name": "Down Time", "description": "Down Time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:36:15" } }, { "productSpecCharacteristicValue": [ { "value": "500 Mbps", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "5 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Bandwidth", "description": "Bandwidth", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:32:11" } }, { "productSpecCharacteristicValue": [ { "value": "4 hrs", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 hr", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Time to Restore (TTR)", "description": "Time to Restore (TTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:37:25" } }, { "productSpecCharacteristicValue": [ { "value": "1 hr", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "4 hrs", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Mean Time to Restore (MTR)", "description": "Mean Time to Restore (MTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:39:05" } }, { "productSpecCharacteristicValue": [ { "value": "No", "validFor": { "startDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "" } } ], "name": "Application Flow Backup", "description": "Application Flow Backup", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:30:39" } }, { "productSpecCharacteristicValue": [ { "value": "99.00", "validFor": { "startDateTime": "" } }, { "value": "99.50", "validFor": { "startDateTime": "" } }, { "value": "99.75", "validFor": { "startDateTime": "" } }, { "value": "99.99", "validFor": { "startDateTime": "" } } ], "name": "Up Time", "description": "Up time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:34:30" } }, { "productSpecCharacteristicValue": [ { "value": "No", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "Yes", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Application Encryption", "description": "Application Encryption", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:29:08" } } ], "status": "published" }' 応答本文： { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "displayName": "SD-WAN Service Package v3", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "description": "SD WAN Service Package", "lastUpdate": "2027-10-11 06:58:12", "isBundle": true, "validFor": { "startDateTime": "2029-02-05", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [ { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "type": "Service", "validFor": { "startDateTime": "2025-01-24", "endDateTime": "" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "1", "numberSpecRelUpperLimit": "1" } }, { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "", "internalVersion": "2", "internalId": "39b627aa53702010cd6dddeeff7b1202", "type": "Service", "validFor": { "startDateTime": "2026-06-05", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "2", "numberSpecRelUpperLimit": "4" } }, { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "", "internalVersion": "2", "internalId": "a6514bd3534560102f18ddeeff7b1247", "type": "Service", "validFor": { "startDateTime": "2026-06-03", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "4", "numberSpecRelUpperLimit": "20" } } ], "resourceSpecification": [], "productSpecCharacteristic": [ { "productSpecCharacteristicValue": [ { "value": "1", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.25", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.01", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.5", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } } ], "name": "Down Time", "description": "Down Time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:36:15" } }, { "productSpecCharacteristicValue": [ { "value": "500 Mbps", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "5 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Bandwidth", "description": "Bandwidth", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:32:11" } }, { "productSpecCharacteristicValue": [ { "value": "4 hrs", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 hr", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Time to Restore (TTR)", "description": "Time to Restore (TTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:37:25" } }, { "productSpecCharacteristicValue": [ { "value": "1 hr", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "4 hrs", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Mean Time to Restore (MTR)", "description": "Mean Time to Restore (MTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:39:05" } }, { "productSpecCharacteristicValue": [ { "value": "No", "validFor": { "startDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "" } } ], "name": "Application Flow Backup", "description": "Application Flow Backup", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:30:39" } }, { "productSpecCharacteristicValue": [ { "value": "99.00", "validFor": { "startDateTime": "" } }, { "value": "99.50", "validFor": { "startDateTime": "" } }, { "value": "99.75", "validFor": { "startDateTime": "" } }, { "value": "99.99", "validFor": { "startDateTime": "" } } ], "name": "Up Time", "description": "Up time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:34:30" } }, { "productSpecCharacteristicValue": [ { "value": "No", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "Yes", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Application Encryption", "description": "Application Encryption", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:29:08" } } ], "status": "published" }' ## 製品カタログオープン API - POST /sn_tmf_api/catalogmanagement/catalog {#ariaid-title16} 製品オファリングカタログを作成します。 ### URL 形式 デフォルト URL: /api/sn_tmf_api/catalogmanagement/catalog ### サポートされている要求パラメーター {#tmf_prod_cat-POST-catalog__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 85. パスパラメーター] {#tmf_prod_cat-POST-catalog__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 86. クエリパラメーター] {#tmf_prod_cat-POST-catalog__entry__10} | 名前 | 説明 | |-|-| | description | 製品オファリングカタログの説明。 データタイプ：文字列 デフォルト：空白の文字列 | | externalId | 外部システムからの製品オファリングカタログの一意の識別子。 データタイプ：文字列 デフォルト：空白の文字列 | | name | 必須です。製品オファリングカタログの名前。 データタイプ：文字列 | [表 : 87. 要求本文パラメーター (JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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 のみをサポートします。 | [表 : 88. 要求ヘッダー] {#tmf_prod_cat-POST-catalog__table_ett_h3z_gsb} {#tmf_prod_cat-POST-catalog__table_tzy_thy_ksb__entry__2} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 89. 応答ヘッダー] {#tmf_prod_cat-POST-catalog__table_tzy_thy_ksb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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} | [表 : 90. ステータスコード] {#tmf_prod_cat-POST-catalog__table_fbw_k3z_gsb} ### 応答本文のパラメーター (JSON) {#tmf_prod_cat-POST-catalog__entry__34} | 名前 | 説明 | |-|-| | description | 製品オファリングカタログの説明。 データタイプ：文字列 | | ID | 製品オファリングカタログのSys_id データタイプ：文字列 テーブル:製品オファリングカタログ \[sn_prd_pm_product_offering_catalog\] | | 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-title17} 製品オファリングおよび関連付けられた製品オファリングバンドルを作成します。 ### URL 形式 デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOffering ### サポートされている要求パラメーター {#tmf_prod_cat-POST-prodoffering__table_o3n_mvf_hsb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 91. パスパラメーター] {#tmf_prod_cat-POST-prodoffering__table_o3n_mvf_hsb} {#tmf_prod_cat-POST-prodoffering__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 92. クエリパラメーター] {#tmf_prod_cat-POST-prodoffering__table_vxh_xvf_hsb__entry__2}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledGroupProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledProductOffering-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_id-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledGroupProductOffering_bundledProductOffering_name-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferDefault-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferLowerLimit-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_bundledProductOfferingOption_numberRelOfferUpperLimit-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_externalId-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_id-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_name-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_version-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-displayName-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-isBundle-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-isSellable-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_description-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_name-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isDefault-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_isMandatory-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_validFor_startDateTime-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_productSpecCharacteristicValue_value-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_validFor-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_validFor_startDateTime-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-prodSpecCharValueUse_valueType-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isDefault-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_isMandatory-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic_characteristicValueSpecification_value-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic_name-entry}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-productOfferingCharacteristic_valueType-entry} | 名前 | 説明 | |-|-| | バンドルされたグループ製品オファリング | 製品オファリングの子グループ。これらは階層的なサブグループ化を示しています。 データタイプ：オブジェクトのアレイ "bundledGroupProductOffering": [ { "bundledGroupProductOfferingOption": {Object}, "bundledProductOffering": [Array],     "id": "String",     "name": "String" } ] | | bundledGroupProductOffering。bundledGroupProductOfferingOption | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限と上限を指定する数値の範囲。 データタイプ: オブジェクト "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferLowerLimit | 関連するバンドル製品オファリングの一部として調達できる製品オファリングの下限。 データタイプ：文字列 | | bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferUpperLimit | 関連するバンドル製品オファリングの一部として調達できる製品オファリングの上限。 データタイプ：文字列 | | bundledGroupProductOffering。bundledProductOffering | バンドルに関連付けられた製品オファリングの子グループ。以下で指定する bundledProductOffering と同じ形式です。 データタイプ：オブジェクトのアレイ | | bundledGroupProductOffering。身分証明書 | バンドルされたグループレコードのSys_id。親製品オファリングまたはグループに複数のグループが含まれている場合に便利です。 データタイプ：文字列 テーブル:製品オファリングの関係グループ \[sn_prd_pm_product_offering_relationship_group\] | | bundledGroupProductOffering。名前 | 子製品オファリングのグループの名前。 データタイプ：文字列 | | バンドルされた製品オファリング | 製品オファリングバンドルに含まれる製品オファリングのリスト。製品オファリングバンドルは、含まれている製品オファリングのすべての属性を継承します。 データタイプ：オブジェクトのアレイ "bundledProductOffering": [ { "bundledProductOfferingOption": {Object},     "externalId": "String",     "id": "String",     "name": "String",     "version": Number } ] | | bundledProductOffering。bundledProductOfferingOption | 製品オファリングのデフォルト数や製品オファリングの上下の調達制約などの製品バンドルオプション。 データタイプ: オブジェクト "bundledProductOfferingOption": { "numberRelOfferDefault": "String", "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferDefault | 関連するバンドル製品オファリングの一部として調達する必要がある製品オファリングのデフォルト数。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferLowerLimit | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferUpperLimit | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の上限。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。externalId | 製品オファリング関係の外部 ID。 製品オファリングの関係の詳細については、「 [Create product offering relationships](https://www.servicenow.com/docs/access?context=som-product-config-offering-relationships&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 データタイプ：文字列 | | bundledProductOffering。身分証明書 | バンドルされた製品オファリングの Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] | | bundledProductOffering。名前 | 製品オファリングバンドルの名前。 データタイプ：文字列 | | bundledProductOffering。バージョン | 製品オファリングのカタログバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | | カテゴリ | 製品が属するカテゴリのリスト。 データタイプ：オブジェクトのアレイ "category:" [ { "id": "String", "name": "String" } ] | | category.id | category パラメーターを使用する場合は必須です。カテゴリの ID。 データタイプ：文字列 テーブル:カテゴリ \[sc_category\] | | category.name | カテゴリの名前。 データタイプ：文字列 テーブル:カテゴリ \[sc_category\] | | チャネル | 必須です。製品オファリングの販売に使用するチャネル。 データタイプ：オブジェクトのアレイ "channel:" [ { "description": "String", "id": "String", "name": "String" } ] | | channel.description | チャネルの説明。 データタイプ：文字列 | | channel.id | 必須です。チャネルのSys_id。 データタイプ：文字列 テーブル:流通チャネル \[sn_prd_pm_distribution_channel\] | | channel.name | チャネルの名前。 データタイプ：文字列 | | description | 必須です。製品オファリングの説明。 データタイプ：文字列 | | displayName | 製品オファリングの表示名。 データタイプ：文字列 | | externalId | 外部システムからの製品オファリングの一意の識別子。 データタイプ：文字列 | | 外部システム | `TMF620` が追加された製品オファリングの外部システム。 たとえば、外部システムが ABC の場合、値は `ABC-TMF620` です。 データタイプ:文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 | | ID | 必須です。製品オファリングの初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのinitial_versionフィールドまたはexternal_idフィールド内。 | | internalId | 製品オファリングレコードの Sys_id ID または内部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、initial_versionフィールド | | internalVersion | 製品オファリングのバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのバージョンフィールド。 | | バンドル | 製品オファリングがバンドルであるかどうかを示すフラグ。 可能な値： * true:製品オファリングはバンドルです。 * false:単一の製品オファリング。 データタイプ：ブーリアン デフォルト値：false | | 販売可能 | 関連付けられた製品オファリングを単独で販売できるか、または製品オファリングバンドルの一部にする必要があるかを示すフラグ。 可能な値： * true:別売りです。 * false:バンドルの一部としてのみ販売されます。 データタイプ：ブーリアン デフォルト値：false | | 前回の更新 | 製品オファリングが最後に更新された日付。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | ライフサイクルステータス | 現在のライフサイクルステータス。 有効な値： * 有効 * ドラフト * 非アクティブ {#tmf_prod_cat-POST-prodoffering__ul_lj5_gg4_4bc} データタイプ：文字列 | | name | 必須です。製品オファリングの名前。 データタイプ：文字列 | | prodSpecCharValueUse | 製品オファリング特性。 データタイプ：オブジェクトのアレイ "prodSpecCharValueUse": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | prodSpecCharValueUse。形容 | 特性の説明。 データタイプ：文字列 | | prodSpecCharValueUse。名前 | 特性の名前。 データタイプ：文字列 | | prodSpecCharValueUse。productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | prodSpecCharValueUse。productSpecCharacteristicValue。isDefault | 関連する特性値が特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値。 * false:デフォルト値ではありません。 デフォルト値：false | | prodSpecCharValueUse。productSpecCharacteristicValue。必須か | 関連する特性値が特性の必須値であるかどうかを示すフラグ。 可能な値： * true:必須の値。 * false:必須の値ではありません。 デフォルト値：false | | prodSpecCharValueUse。productSpecCharacteristicValue。validFor | 特性が有効になった日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse。productSpecCharacteristicValue。validFor。startDateTime | 特性値が有効になる開始日時。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse。productSpecCharacteristicValue。価値 | 特性の値。 データタイプ：文字列 | | prodSpecCharValueUse。validFor | 特性が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse。validFor。startDateTime | 特性の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse。値タイプ | prodSpecCharValueUse.productSpecCharacteristicValue.valueパラメーターのデータタイプ。 可能な値： * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line Test * チェックボックス * 選択肢 * 日付、住所 * メール * 整数、日付/時刻 * オブジェクト * 1 行テキスト * はい/いいえ {#tmf_prod_cat-POST-prodoffering__ul_fhv_2jw_xfc} データタイプ：文字列 | | 製品特性 | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] | | productCharacteristic.name | 特性の名前。 データタイプ：文字列 | | productCharacteristic.value | 特性の値。 データタイプ：文字列 | | 製品オファリング特性 | 製品オファリングの特徴的な品質または特徴的な機能。特性は、モバイル計画ランクなど、設計時 (カタログオーサリング) に固定された不連続値を取ることができます。これらの特性は、通常、在庫レベルでは変更できません。 製品オファリング特性の詳細については、「 [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 データタイプ：オブジェクトのアレイ productOfferingCharacteristic": [  { "characteristicValueSpecification": [Array], "name": "String", "valueType": "String" } ] | | productOfferingCharacteristic。characteristicValueSpecification | 製品オファリング特性に関連付けられた特性値のリスト。 データタイプ：オブジェクトのアレイ "characteristicValueSpecification": [  { "isDefault": Boolean, "isMandatory": Boolean, "value": "String" }  ] | | productOfferingCharacteristic。characteristicValueSpecificationです。isDefault | 関連する特性値が関連する特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値です。 * false:デフォルト値ではありません。 データタイプ：ブーリアン デフォルト値：false | | productOfferingCharacteristic。characteristicValueSpecificationです。必須か | 関連する特性値が関連する特性に必須かどうかを示すフラグ。 可能な値： * true:必須です。 * false:必須ではありません。 データタイプ：ブーリアン デフォルト値：false | | productOfferingCharacteristic。characteristicValueSpecificationです。価値 | 関連する製品仕様特性に割り当てられた番号またはテキスト。 たとえば、次のようになります。 "characteristicValueSpecification": [ { "value": "choice 1" }, { "value": "choice 2" } ] データタイプ：文字列 | | productOfferingCharacteristic。名前 | 関連付けられた製品オファリング特性の名前。 データタイプ：文字列 | | productOfferingCharacteristic。値タイプ | productOfferingCharacteristic.characteristicValueSpecification.valueパラメーターのデータタイプ。 可能な値： * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line Test * チェックボックス * 選択肢 * 日付、住所 * メール * 整数、日付/時刻 * オブジェクト * 1 行テキスト * はい/いいえ {#tmf_prod_cat-POST-prodoffering__ul_jpt_fjw_xfc} データタイプ：文字列 | | 製品オファリング価格 | 製品オファリングの価格情報。 データタイプ：オブジェクトのアレイ "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] | | productOfferingPrice.price | 製品オファリングの価格情報。 データタイプ: オブジェクト "price": { "taxIncludedAmount": {Object} } | | productOfferingPrice.price.taxIncludedAmount | 製品オファリングの価格情報。 データタイプ: オブジェクト "taxIncludedAmount": { "unit": "String", "value": "String" } | | productOfferingPrice.price.taxIncludedAmount.unit | 製品オファリング価格の通貨コード。 データタイプ：文字列 フォーマット:ISO 4217 | | productOfferingPrice.price.taxIncludedAmount.value | 税込みの製品オファリングの価格。 データタイプ：文字列 | | productOfferingPrice.priceType | productOfferingPrice パラメーターを使用する場合は必須です。製品オファリング価格タイプ (1 回払いまたは繰り返し支払い)。 有効な値： * 非繰り返し (1 回限り) * 繰り返し {#tmf_prod_cat-POST-prodoffering__ul_gdl_4ty_1hc} データタイプ：文字列 | | productOfferingTerm | 製品オファリングの有効な契約期間 (12 か月、24 か月、not_applicableなど)。 データタイプ：文字列 | | 製品仕様 | 必須です。製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "name" "version": "String" } | | productSpecification.id | 必須です。製品仕様の初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのinitial_versionフィールドまたはexterna_idフィールド。 | | productSpecificationです。内部 ID | 製品仕様レコードの Sys_id ID または内部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[initial_version\] フィールド。 | | productSpecificationです。内部バージョン | 製品仕様のバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのバージョンフィールド。 | | productSpecificationです。名前 | 製品仕様の名前。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの名前フィールド。 | | productSpecificationです。バージョン | 製品仕様の外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | | validFor | 必須です。製品オファリングが有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor.endDateTime | 製品オファリングの終了日。 データタイプ：文字列 形式：YYYY-MM-DD | | validFor.startDateTime | 製品オファリングの開始日。 データタイプ：文字列 形式：YYYY-MM-DD | | バージョン | 製品オファリングの外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | [表 : 93. 要求本文パラメーター (JSON)] {#tmf_prod_cat-POST-prodoffering__table_vxh_xvf_hsb} ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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 のみをサポートします。 | [表 : 94. 要求ヘッダー] {#tmf_prod_cat-POST-prodoffering__table_ett_h3z_gsb} {#tmf_prod_cat-POST-prodoffering__table_tzy_thy_ksb__entry__2}{#tmf_prod_cat-POST-prodoffering__d3014e217} | ヘッダー | 説明 | |-|-| | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 95. 応答ヘッダー] {#tmf_prod_cat-POST-prodoffering__table_tzy_thy_ksb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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} | [表 : 96. ステータスコード] {#tmf_prod_cat-POST-prodoffering__table_fbw_k3z_gsb} ### 応答本文のパラメーター {#tmf_prod_cat-POST-prodoffering__entry__178}{#tmf_prod_cat-POST-prodoffering__d3125e285}{#tmf_prod_cat-POST-prodoffering__d3125e298}{#tmf_prod_cat-POST-prodoffering__d3125e311}{#tmf_prod_cat-POST-prodoffering__d3125e322}{#tmf_prod_cat-POST-prodoffering__d3125e333}{#tmf_prod_cat-POST-prodoffering__d3125e387}{#tmf_prod_cat-POST-prodoffering__d3125e400}{#tmf_prod_cat-POST-prodoffering__d3125e411}{#tmf_prod_cat-POST-prodoffering__d3125e425}{#tmf_prod_cat-POST-prodoffering__d3125e438}{#tmf_prod_cat-POST-prodoffering__d3125e451}{#tmf_prod_cat-POST-prodoffering__d3125e464}{#tmf_prod_cat-POST-prodoffering__d3125e477}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-bundledProductOffering_href-entry}{#tmf_prod_cat-POST-prodoffering__d3125e505}{#tmf_prod_cat-POST-prodoffering__d3125e518}{#tmf_prod_cat-POST-prodoffering__d3125e529}{#tmf_prod_cat-POST-prodoffering__d3125e619}{#tmf_prod_cat-POST-prodoffering__d3125e642}{#tmf_prod_cat-POST-prodoffering__d3125e692}{#tmf_prod_cat-POST-prodoffering__d3125e705}{#tmf_prod_cat-POST-prodoffering__d3125e716}{#tmf_prod_cat-POST-prodoffering__d3125e730}{#tmf_prod_cat-POST-prodoffering__d3125e746}{#tmf_prod_cat-POST-prodoffering__d3125e767}{#tmf_prod_cat-POST-prodoffering__d3125e789}{#tmf_prod_cat-POST-prodoffering__d3125e802}{#tmf_prod_cat-POST-prodoffering__d3125e815}{#tmf_prod_cat-POST-prodoffering__d3125e829}{#tmf_prod_cat-POST-prodoffering__d3125e842}{#tmf_prod_cat-POST-prodoffering__d3125e855}{#tmf_prod_cat-POST-prodoffering__d3125e917}{#tmf_prod_cat-POST-prodoffering__d3125e935}{#tmf_prod_cat-POST-prodoffering__d3125e948}{#tmf_prod_cat-POST-prodoffering__d3125e971}{#tmf_prod_cat-POST-prodoffering__d3125e994}{#tmf_prod_cat-POST-prodoffering__d3125e1009}{#tmf_prod_cat-POST-prodoffering__d3125e1021}{#tmf_prod_cat-POST-prodoffering__prodCat-offering-status-entry} | 名前 | 説明 | |-|-| | バンドルされたグループ製品オファリング | 製品オファリングの子グループ。これらは階層的なサブグループ化を示しています。 データタイプ：オブジェクトのアレイ "bundledGroupProductOffering": [ { "bundledGroupProductOfferingOption": {Object}, "bundledProductOffering": [Array],     "id": "String",     "name": "String" } ] | | bundledGroupProductOffering。bundledGroupProductOfferingOption | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限と上限を指定する数値の範囲。 データタイプ: オブジェクト "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferLowerLimit | 関連するバンドル製品オファリングの一部として調達できる製品オファリングの下限。 データタイプ：文字列 | | bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferUpperLimit | 関連するバンドル製品オファリングの一部として調達できる製品オファリングの上限。 データタイプ：文字列 | | bundledGroupProductOffering。bundledProductOffering | バンドルに関連付けられた製品オファリングの子グループ。以下で指定する bundledProductOffering と同じ形式です。 データタイプ：オブジェクトのアレイ | | bundledGroupProductOffering。身分証明書 | バンドルされたグループレコードのSys_id。親製品オファリングまたはグループに複数のグループが含まれている場合に便利です。 データタイプ：文字列 テーブル:製品オファリングの関係グループ \[sn_prd_pm_product_offering_relationship_group\] | | bundledGroupProductOffering。名前 | 子製品オファリングのグループの名前。 データタイプ：文字列 | | バンドルされた製品オファリング | 製品オファリングバンドルに含まれる製品オファリングのリスト。製品オファリングバンドルは、含まれている製品オファリングのすべての属性を継承します。 データタイプ：オブジェクトのアレイ "bundledProductOffering": [ { "bundledProductOfferingOption": {Object},     "externalId": "String", "href": "String",     "id": "String",     "name": "String",     "version": Number } ] | | bundledProductOffering。bundledProductOfferingOption | 製品オファリングのデフォルト数や製品オファリングの上下の調達制約などの製品バンドルオプション。 データタイプ: オブジェクト "bundledProductOfferingOption": { "numberRelOfferDefault": "String", "numberRelOfferLowerLimit": "String",   "numberRelOfferUpperLimit": "String" } | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferDefault | 関連するバンドル製品オファリングの一部として調達する必要がある製品オファリングのデフォルト数。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferLowerLimit | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。bundledProductOfferingOption。numberRelOfferUpperLimit | 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の上限。 データタイプ：文字列 可能な値:0 からバインド解除。 | | bundledProductOffering。externalId | 製品オファリング関係の外部 ID。 製品オファリングの関係の詳細については、「 [Create product offering relationships](https://www.servicenow.com/docs/access?context=som-product-config-offering-relationships&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 データタイプ：文字列 | | bundledProductOffering。HREF | 関連する製品オファリングへの相対リンク。 データタイプ：文字列 | | bundledProductOffering。身分証明書 | バンドルされた製品オファリングの Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] | | bundledProductOffering。名前 | 製品オファリングバンドルの名前。 データタイプ：文字列 | | bundledProductOffering。バージョン | 製品オファリングのカタログバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | | category | 製品が属するカテゴリのリスト。 データタイプ：オブジェクトのアレイ "category:" [ { "id": "String", "name": "String" } ] | | category.id | カテゴリの ID。 データタイプ：文字列 | | category.name | カテゴリの名前。 データタイプ：文字列 | | チャネル | 製品オファリングの販売に使用するチャネル。 データタイプ：オブジェクトのアレイ "channel:" [ { "description": "String", "id": "String", "name": "String" } ] | | チャンネル。形容 | チャネルの説明。 データタイプ：文字列 | | channel.id | チャネルのSys_id。 データタイプ：文字列 テーブル:流通チャネル \[sn_prd_pm_distribution_channel\] | | channel.name | チャネルの名前。 データタイプ：文字列 | | description | 製品オファリングの説明。 データタイプ：文字列 | | externalId | 製品オファリングの外部 ID。複数のバージョンが公開されている場合は、その中で最も高い公開バージョンを返します。バージョンが公開されていない場合は、ステータスに関係なく最も高いバージョンを返します。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、external_idフィールド | | 外部システム | `TMF620` が追加された製品オファリングの外部システム。 たとえば、外部システムが ABC の場合、値は `ABC-TMF620` です。 データタイプ:文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 | | ID | 必須です。製品オファリングの初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、initial_versionフィールドまたはexternal_idフィールド | | internalId | 製品オファリングレコードの Sys_id ID または内部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブル、initial_versionフィールド | | internalVersion | 製品オファリングのバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのバージョンフィールド。 | | バンドル | 製品オファリングがバンドルであるかどうかを示すフラグ。 可能な値： * true:製品オファリングはバンドルです。 * false:単一の製品オファリング。 データタイプ：ブーリアン デフォルト値：false | | 販売可能 | 関連付けられた製品オファリングを単独で販売できるか、または製品オファリングバンドルの一部にする必要があるかを示すフラグ。 可能な値： * true:別売りです。 * false:バンドルの一部としてのみ販売されます。 データタイプ：ブーリアン デフォルト値：false | | 前回の更新 | 製品オファリングが最後に更新された日付。 データタイプ：文字列 | | ライフサイクルステータス | 製品オファリングの現在のライフサイクルステータス。 有効な値： * 有効 * ドラフト * 非アクティブ データタイプ：文字列 デフォルト：空白の文字列 | | name | 製品オファリングの名前。 データタイプ：文字列 | | prodSpecCharValueUse | 製品オファリング特性。 データタイプ：オブジェクトのアレイ "prodSpecCharValueUse": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | prodSpecCharValueUse。形容 | 特性の説明。 データタイプ：文字列 | | prodSpecCharValueUse。名前 | 特性の名前。 データタイプ：文字列 | | prodSpecCharValueUse。productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | prodSpecCharValueUse。productSpecCharacteristicValue。isDefault | 関連する特性値が特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値。 * false:デフォルト値ではありません。 デフォルト値：false | | prodSpecCharValueUse。productSpecCharacteristicValue。必須か | 関連する特性値が特性の必須値であるかどうかを示すフラグ。 可能な値： * true:必須の値。 * false:必須の値ではありません。 デフォルト値：false | | prodSpecCharValueUse。productSpecCharacteristicValue。validFor | 特性が有効になった日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse。productSpecCharacteristicValue。validFor。startDateTime | 特性値が有効になる開始日時。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse。productSpecCharacteristicValue。価値 | 特性の値。 データタイプ：文字列 | | prodSpecCharValueUse。validFor | 特性が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | prodSpecCharValueUse。validFor。startDateTime | 特性の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | prodSpecCharValueUse。値タイプ | prodSpecCharValueUse.productSpecCharacteristicValue.valueパラメーターのデータタイプ。 可能な値： * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line Test * チェックボックス * 選択肢 * 日付、住所 * メール * 整数、日付/時刻 * オブジェクト * 1 行テキスト * はい/いいえ {#tmf_prod_cat-POST-prodoffering__d3125e861} データタイプ：文字列 | | 製品特性 | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] | | productCharacteristicです。名前 | 特性の名前。 データタイプ：文字列 | | productCharacteristicです。価値 | 特性の値。 データタイプ：文字列 | | 製品オファリング特性 | 製品オファリングの特徴的な品質または特徴的な機能。特性は、モバイル計画ランクなど、設計時 (カタログオーサリング) に固定された不連続値を取ることができます。これらの特性は、通常、在庫レベルでは変更できません。 製品オファリング特性の詳細については、「 [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=australia&pubname=australia-order-management&ft:locale=en-US)」を参照してください。 データタイプ：オブジェクトのアレイ productOfferingCharacteristic": [  { "characteristicValueSpecification": [Array], "name": "String", "valueType": "String" } ] | | productOfferingCharacteristic。characteristicValueSpecification | 製品オファリング特性に関連付けられた特性値のリスト。 データタイプ：オブジェクトのアレイ "characteristicValueSpecification": [  { "isDefault": Boolean, "isMandatory": Boolean, "value": "String" }  ] | | productOfferingCharacteristic。characteristicValueSpecificationです。isDefault | 関連する特性値が関連する特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値です。 * false:デフォルト値ではありません。 データタイプ：ブーリアン デフォルト値：false | | productOfferingCharacteristic。characteristicValueSpecificationです。必須か | 関連する特性値が関連する特性に必須かどうかを示すフラグ。 可能な値： * true:必須です。 * false:必須ではありません。 データタイプ：ブーリアン デフォルト値：false | | productOfferingCharacteristic。characteristicValueSpecificationです。価値 | 関連する製品仕様特性に割り当てられた番号またはテキスト。 たとえば、次のようになります。 "characteristicValueSpecification": [ { "value": "choice 1" }, { "value": "choice 2" } ] データタイプ：文字列 | | productOfferingCharacteristic。名前 | 関連付けられた製品オファリング特性の名前。 データタイプ：文字列 | | productOfferingCharacteristic。値タイプ | productOfferingCharacteristic.characteristicValueSpecification.valueパラメーターのデータタイプ。 可能な値： * Array.Date * Array.Datetime * Array.Decimal * Array.Integer * Array.Object * Array.Single Line Test * チェックボックス * 選択肢 * 日付、住所 * メール * 整数、日付/時刻 * オブジェクト * 1 行テキスト * はい/いいえ {#tmf_prod_cat-POST-prodoffering__d3125e1027} データタイプ：文字列 | | 製品オファリング価格 | 製品オファリングの価格情報。 データタイプ：オブジェクトのアレイ "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] | | productOfferingPrice です。価格 | 製品オファリングの価格情報。 データタイプ: オブジェクト "price": { "taxIncludedAmount": {Object} } | | productOfferingPrice です。価格。税込み金額 | 製品オファリングの価格情報。 データタイプ: オブジェクト "taxIncludedAmount": { "unit": "String", "value": "String" } | | productOfferingPrice です。価格。taxIncludedAmount.unit | 製品オファリング価格の通貨コード。 データタイプ：文字列 | | productOfferingPrice です。価格。taxIncludedAmount です。価値 | 税込みの製品オファリングの価格。 データタイプ：文字列 | | productOfferingPrice です。価格タイプ | 製品オファリング価格タイプ (1 回払いまたは繰り返し支払い)。 可能な値： * 非繰り返し (1 回限り) * 繰り返し {#tmf_prod_cat-POST-prodoffering__ul_lwl_pty_1hc} データタイプ：文字列 | | productOfferingTerm | 製品オファリングの有効な契約期間。 データタイプ：文字列 | | 製品仕様 | 製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productSpecificationです。身分証明書 | 製品仕様レコードのSys_id。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[initial_version\] フィールド。 | | productSpecificationです。内部 ID | 製品仕様レコードの Sys_id ID または内部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[initial_version\] フィールド。 | | productSpecificationです。内部バージョン | 製品仕様のバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルのバージョンフィールド。 | | productSpecificationです。バージョン | 製品仕様の外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | | ステータス | 製品オファリングのステータス。 可能な値： * ドラフト * 公開済み データタイプ：文字列 | | validFor | 製品オファリングが有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor。endDateTime | 製品オファリングの終了日。 データタイプ：文字列 | | validFor。startDateTime | 製品オファリングの開始日。 データタイプ：文字列 | | バージョン | 製品オファリングの外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] テーブルの \[external_version\] フィールド。 | [ ] この例では、製品オファリングを作成します。 curl --location --request POST "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productOffering" \ --header "Content-Type: application/json" \ --header "Accept:application/json" \ --data-raw '{ "id": "313b917843235210a82ed6085bb8f2c7",, "externalSystem": "Salesforce-TMF620", "name": "Internet bundle", "displayName": "Internet bundle", "description": "Internet bundle", "isSellable": false, "lifecycleStatus": "Draft", "isBundle": true, "lastUpdate": "2025-02-05 06:39:45", "version": "", "internalVersion": "1", "internalId": "313b917843235210a82ed6085bb8f2c7", "validFor": { "startDateTime": "2028-12-15", "endDateTime": "2034-01-14" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } } ], "productOfferingCharacteristic": [ { "name": "Firewall Security", "valueType": "choice", "characteristicValueSpecification": [ { "value": "Premium", "isMandatory": false, "isDefault": true } ] }, { "name": "Connectivity need", "valueType": "choice", "characteristicValueSpecification": [ { "value": "When in use", "isMandatory": false, "isDefault": false } ] } ], "bundledProductOffering": [ { "id": "0f61dd9fd0a63110f8770dbf976be168", "name": "Solana Sports streaming channel", "version": "1", "externalId": "EXT-123", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOffering": [ { "id": "063b957843235210a82ed6085bb8f205", "name": "Streaming Channel", "bundledProductOffering": [ { "id": "62619d9fd0a63110f8770dbf976be180", "name": "Solana Movie streaming channel", "version": "1", "externalId": "EXT-345", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6" }, "prodSpecCharValueUse": [ { "name": "Tenancy", "description": "Tenancy", "valueType": "choice", "validFor": { "startDatetime": "2024-12-18 21:04:24" }, "productSpecCharacteristicValue": [ { "value": "Premium (>50 sites)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } }, { "value": "Base (10 site)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5" } } ], "channel": [ { "id": "58ad5522c3702010df4773ce3640ddb2", "name": "Agent Assist" } ], "category": [ { "id": "13e305a143b631105029d1529ab8f267", "name": "SD-WAN_all_offers" } ], "status": "draft" }' --user 'username':'password' 応答本文： { "id": "313b917843235210a82ed6085bb8f2c7", "name": "Internet bundle", "externalSystem": "Salesforce-TMF620", "displayName": "Internet bundle", "description": "Internet bundle", "isSellable": false, "lifecycleStatus": "Draft", "isBundle": true, "lastUpdate": "2025-04-09 15:59:09", "version": "", "internalVersion": "1", "validFor": { "startDateTime": "2028-12-15", "endDateTime": "2034-01-14" }, "productOfferingTerm": "not_applicable", "productOfferingPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": "0" } } } ], "productOfferingCharacteristic": [ { "name": "Firewall Security", "valueType": "choice", "characteristicValueSpecification": [ { "value": "Premium", "isMandatory": false, "isDefault": true } ] }, { "name": "Connectivity need", "valueType": "choice", "characteristicValueSpecification": [ { "value": "When in use", "isMandatory": false, "isDefault": false } ] } ], "bundledProductOffering": [ { "id": "0f61dd9fd0a63110f8770dbf976be168", "name": "Solana Sports streaming channel", "version": "1", "externalId": "EXT-123", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOffering": [ { "id": "063b957843235210a82ed6085bb8f205", "name": "Streaming Channel", "bundledProductOffering": [ { "id": "62619d9fd0a63110f8770dbf976be180", "name": "Solana Movie streaming channel", "version": "1", "externalId": "EXT-345", "bundledProductOfferingOption": { "numberRelOfferDefault": "1", "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "bundledGroupProductOfferingOption": { "numberRelOfferLowerLimit": "1", "numberRelOfferUpperLimit": "1" } } ], "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6" }, "prodSpecCharValueUse": [ { "name": "Tenancy", "description": "Tenancy", "valueType": "choice", "validFor": { "startDatetime": "2024-12-18 21:04:24" }, "productSpecCharacteristicValue": [ { "value": "Premium (>50 sites)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } }, { "value": "Base (10 site)", "isDefault": false, "isMandatory": false, "validFor": { "startDateTime": "" } } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5" } } ], "channel": [ { "id": "58ad5522c3702010df4773ce3640ddb2", "name": "Agent Assist" } ], "category": [ { "id": "13e305a143b631105029d1529ab8f267", "name": "SD-WAN_all_offers" } ], "status": "draft", "externalId": "313b917843235210a82ed6085bb8f2c7", "internalId": "03c99cb53bf066509b48d69a04e45a11", "href": "/api/sn_tmf_api/catalogmanagement/productOffering/03c99cb53bf066509b48d69a04e45a11" } ## 製品カタログオープン API - POST /sn_tmf_api/catalogmanagement/productOfferingPrice {#ariaid-title18} 価格明細 \[sn_csm_pricing_price_list_line\] テーブルに新しい価格明細レコードを作成します。 ### URL 形式 デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice ### サポートされている要求パラメーター {#tmf_prod_order-POST-prodofferprice__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 97. パスパラメーター] {#tmf_prod_order-POST-prodofferprice__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 98. クエリパラメーター] {#tmf_prod_order-POST-prodofferprice__id_b21_1nc_f2c__entry__2} | 名前 | 説明 | |-|-| | @type | 必須です。価格明細のタイプ。常に `ProductOfferingPrice` の値です。 データタイプ：文字列 | | externalId | 価格明細の外部 ID。 データタイプ：文字列 | | バンドル | 価格明細が単一の製品の一部であるか、製品のバンドルの一部であるかを示すフラグ。 有効な値： * true:価格明細はバンドルの一部です。 * false:価格明細はバンドルの一部ではありません。 データタイプ：ブーリアン デフォルト値：false | | 前回の更新 | 必須です。価格行が最後に更新された日付。 形式：YYYY-MM-DD データタイプ：文字列 | | ライフサイクルステータス | 必須です。製品リスト明細の現在のライフサイクルステータス。 有効な値： * アクティブ * ドラフト * inactive データタイプ：文字列 デフォルト:ドラフト | | name | 必須です。価格明細に付ける名前。 データタイプ：文字列 | | 価格 | 必須です。価格明細の表示価格の詳細。 データタイプ: オブジェクト "price": { "unit": "String", "value": "String" } | | price.unit | 必須です。価格明細の通貨コード。たとえば、 `USD` や `EUR` などです。 テーブル:通貨 \[fx_currency\] テーブル。 データタイプ：文字列 | | price.value | 必須です。価格の値。 データタイプ:文字列 (数値で表されます。例:「 `800」)`。 | | priceList | 必須です。価格明細に関連付けられた価格リスト情報。 データタイプ: オブジェクト "priceList": { "id": "String", "name": "String", "@type": "String" } | | priceList.id | 必須です。価格明細のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | priceList.name | 価格明細の名前。 データタイプ：文字列 | | priceList.@type | 価格明細のタイプ。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。値は常に `priceList` です。 データタイプ：文字列 | | 価格タイプ | 必須です。製品オファリングの価格設定方法で価格明細をフィルタリングします。 有効な値： * recurring:指定された頻度で繰り返し価格設定金額を請求します。頻度は recurringChargePeriodType パラメーターで設定します。 * one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金と料金をサポートします。 データタイプ：文字列 デフォルト:繰り返し | | productOffering | 必須です。価格明細の製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } | | productOffering です。身分証明書 | 必須。製品オファリングのSys_id。 テーブル:製品オファリング \[sn_prd_pm_product_offering\] データタイプ：文字列 | | productOffering です。内部バージョン | 製品オファリングの内部バージョン番号。 データタイプ:文字列 (数値で表されます。たとえば `、「1」`など)。 | | productOffering です。名前 | 製品オファリングの名前。 データタイプ：文字列 | | recurringChargePeriodType | priceTypeを繰り返す場合は必須です。製品オファリングの作成時に選択されたコミットメント期間。 有効な値： * 年次 * 月次 データタイプ：文字列 | | 測定単位 | 必須です。価格明細に関連付けられた測定単位に関する詳細。 データタイプ: オブジェクト "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } | | unitOfMeasure です。量 | 測定単位の金額。 データタイプ：数値 | | unitOfMeasure です。身分証明書 | 必須。価格ラインリストテーブルの測定単位のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | unitOfMeasure です。単位 | 価格明細に関連付けられた測定単位のタイプ。たとえば、`各または``バンドル`です。 データタイプ：文字列 | | validFor | 必須です。価格明細が有効な期間。 データタイプ: オブジェクト "validFor": { "endDate": "String", "startDate": "String" } | | validFor.endDate | 価格明細が有効な終了日。 データタイプ:文字列 (glide_date_time) | | validFor.endDateTime | 価格明細が有効な終了日時。 形式:YYYY-MM-DD HH:mm:ss データタイプ:文字列 (glide_date) | | validFor.startDate | 価格明細が有効な開始日。 データタイプ:文字列 (glide_date_time) | | validFor.startDateTime | 価格明細が有効な開始日時。 形式:YYYY-MM-DD HH:mm:ss データタイプ:文字列 (glide_date) | [表 : 99. 要求本文パラメーター (XML または JSON)] {#tmf_prod_order-POST-prodofferprice__id_b21_1nc_f2c} ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#tmf_prod_order-POST-prodofferprice__entry__68}{#tmf_prod_order-POST-prodofferprice__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 100. 要求ヘッダー] {#tmf_prod_order-POST-prodofferprice__entry__72} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 101. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#tmf_prod_order-POST-prodofferprice__table_onp_pnw_22c__entry__2}{#tmf_prod_order-POST-prodofferprice__entry-200-status-code}{#tmf_prod_order-POST-prodofferprice__entry-404-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。 考えられる理由: * 無効なパスパラメーター * 無効な URI {#tmf_prod_order-POST-prodofferprice__ul_qkg_2rv_22c} | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | [表 : 102. ステータスコード] {#tmf_prod_order-POST-prodofferprice__table_onp_pnw_22c} ### 応答本文のパラメーター (JSON または XML) {#tmf_prod_order-POST-prodofferprice__entry__84} | 名前 | 説明 | |-|-| | ID | 価格明細のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | href | インスタンス内の価格明細レコードへの URL。 データタイプ：文字列 | | 前回の更新 | 価格明細が最後に更新された日時。 形式:YYYY-MM-DD HH:mm:ss データタイプ：文字列 | | validFor | 価格明細が有効な期間。 データタイプ: オブジェクト "validFor": { "endDate": "String", "startDate": "String" } | | validFor.endDate | 価格明細が有効な終了日時。 データタイプ:文字列 (glide_date_time) | | validFor.startDate | 価格明細が有効な開始日時。 データタイプ:文字列 (glide_date_time) | | バンドル | 価格明細が単一の製品の一部であるか、製品のバンドルの一部であるかを示すフラグ。 有効な値： * true:価格明細はバンドルの一部です。 * false:価格明細はバンドルの一部ではありません。 データタイプ：ブーリアン | | ライフサイクルステータス | 価格明細の現在のライフサイクル状況。 有効な値： * 有効 * ドラフト * 非アクティブ データタイプ：文字列 | | productOffering | 価格明細に関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } | | productOffering.id | 製品オファリングのSys_id。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 | | productOffering です。内部バージョン | 製品オファリングの内部バージョン番号。たとえば、 `PRDOF01024` などです。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 | | productOffering です。名前 | 製品オファリングの名前。製品オファリング \[sn_prd_pm_product_offering\] テーブルにあります。 データタイプ：文字列 | | 価格タイプ | この価格明細に関連付けられている製品オファリングの価格設定方法。 可能な値： * recurring:指定された頻度で繰り返し価格設定金額を請求します。recurringChargePeriodTypeの値は、充電の頻度を示します。 * one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金および料金。 データタイプ：文字列 | | recurringChargePeriodType | この価格明細に関連付けられた製品オファリングの周期性または頻度。繰り返し`に設定されている場合`は頻度タイプpriceType返し、それ以外の場合は空の文字列を返します。 可能な値： * 年次 * 月次 データタイプ：文字列 | | 測定単位 | 価格明細に関連付けられた測定単位に関する詳細。 データタイプ: オブジェクト "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } | | unitOfMeasure.amount | 測定単位の金額。 データタイプ：数値 | | unitOfMeasure.id | 測定単位のSys_id。 テーブル:価格明細 \[sn_csm_pricing_price_list_line\] データタイプ：文字列 | | unitOfMeasure です。単位 | 価格明細に関連付けられた測定単位のタイプ。たとえば、 `年` や `バンドル`などです。 データタイプ：文字列 | | 価格 | 価格明細の表示価格の詳細。 データタイプ: オブジェクト "price": { "units": "String", "value": "String" } | | price.units | 価格の通貨コード。たとえば、 `USD` や `EUR` などです。 テーブル:通貨 \[fx_currency\] データタイプ：文字列 | | price.value | 価格の値。 データタイプ:文字列 (数値で表される) | | priceList | 価格明細に関連付けられた価格リスト情報。 データタイプ: オブジェクト "priceList": { "id": "String", "name": "String", "@type": "String" } | | priceList.id | 価格リスト \[sn_csm_pricing_price_list\] テーブルの価格リストのSys_id。 データタイプ：文字列 | | priceList.name | 価格リストの名前。 データタイプ：文字列 | | priceList.@type | 価格リストのタイプ。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。常に `priceList` の値を持ちます。 データタイプ：文字列 | | @type | 常に `ProductOfferingPrice` の値です。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。 データタイプ：文字列 | | 状況 | この価格明細に関連付けられている価格リストのステータス。 データタイプ：文字列 | | externalId | この価格明細の外部 ID。 データタイプ：文字列 | [ ] ### cURL 要求 次の例では、要求本文で指定されたデータに従って新しい価格明細レコードを作成し、価格明細 \[sn_csm_pricing_price_list_line\] テーブルに挿入します。 curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOfferingPrice " \ --request POST\ --user 'username':'password' --data { "name": "new Price list", "validFor": { "startDateTime": "2024-05-28 15:15:58", "endDateTime": "2025-06-28 15:15:58" }, "priceType": "recurring", "recurringChargePeriodType": "monthly", "lastUpdate": "2023-09-23 00:00:00", "isBundle": false, "lifecycleStatus": "Draft", "unitOfMeasure": { "id": "1eaa559953020110286eddeeff7b12c7", "amount": 1, "units": "Year" }, "price": { "unit": "USD", "value": "800" }, "productOffering": { "id": "9e3dd57a4fcb5210f899f61d20ce0bf2", "name": "Maintenance Fee", "internalVersion": "1" }, "priceList": { "name": "new price list", "@type": "priceList" }, "externalId": "test123", "@type": "ProductOfferingPrice" } 応答本文。この新しい価格明細レコードには一意の ID が割り当てられます。応答本文は、 href 応答パラメーターを使用して、この情報と新しいレコードへの URL を返します。 { "name": "new Price list", "validFor": { "startDateTime": "2024-05-28 15:15:58", "endDateTime": "2025-06-28 15:15:58" }, "priceType": "recurring", "recurringChargePeriodType": "monthly", "lastUpdate": "2023-09-23 00:00:00", "isBundle": false, "lifecycleStatus": "Draft", "unitOfMeasure": { "id": "1eaa559953020110286eddeeff7b12c7", "amount": 1, "units": "Year" }, "price": { "unit": "USD", "value": "800" }, "productOffering": { "id": "9e3dd57a4fcb5210f899f61d20ce0bf2", "name": "Maintenance Fee", "internalVersion": "1" }, "priceList": { "id": "194d5d364f8b5210f899f61d20ce0b7a", "name": "new Price list", "@type": "priceList" }, "externalId": "test123", "@type": "ProductOfferingPrice", "id": "994d5d364f8b5210f899f61d20ce0b7c", "state": "draft", "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/994d5d364f8b5210f899f61d20ce0b7c" } ## 製品カタログオープン API - POST /sn_tmf_api/catalogmanagement/productSpecification {#ariaid-title19} 指定された値で製品仕様レコードを作成します。 ### URL 形式 デフォルト URL: /api/sn_tmf_api/catalogmanagement/productSpecification ### サポートされている要求パラメーター {#tmf_prod_cat-POST-prodspec__table_jdq_g51_jsb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 103. パスパラメーター] {#tmf_prod_cat-POST-prodspec__table_jdq_g51_jsb} {#tmf_prod_cat-POST-prodspec__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 104. クエリパラメーター] {#tmf_prod_cat-POST-prodspec__table_db1_q51_jsb__entry__2} | 名前 | 説明 | |-|-| | description | 必須です。仕様の説明。 データタイプ：文字列 | | externalId | 外部システムからの製品仕様の一意の識別子。 データタイプ：文字列 デフォルト：空白の文字列 | | 外部システム | `TMF620` が追加された製品仕様の外部システム。 たとえば、外部システムが ABC の場合、値は `ABC-TMF620` です。 データタイプ:文字列 | | ID | 必須。製品仕様の Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのinitial_versionまたはexternal_id内。 | | internalId | 必須。 製品仕様のSys_idまたは内部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルの initial_version フィールド内。 | | internalVersion | 製品仕様のバージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのバージョンフィールド。 | | 前回の更新 | 仕様が最後に更新された日付。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS。例: `2025-01-31 09:35:43`。 デフォルト：空白の文字列 | | name | 必須です。仕様の名前。 データタイプ：文字列 | | 製品仕様特性 | 仕様特性。 データタイプ：オブジェクトのアレイ "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | productSpecCharacteristicです。形容 | 特性の説明。 データタイプ：文字列 デフォルト：空白の文字列 | | productSpecCharacteristicです。名前 | 必須。特性の名前。 データタイプ：文字列 | | productSpecCharacteristicです。productSpecCharacteristicValue | 必須。 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | productSpecCharacteristicです。productSpecCharacteristicValue。isDefault | 関連する特性値が特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値。 * false:デフォルト値ではありません。 デフォルト値：false | | productSpecCharacteristicです。productSpecCharacteristicValue。必須か | 関連する特性値が特性の必須値であるかどうかを示すフラグ。 可能な値： * true:必須の値。 * false:必須の値ではありません。 デフォルト値：false | | productSpecCharacteristicです。productSpecCharacteristicValue。validFor | 特性が有効になった日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | productSpecCharacteristicです。productSpecCharacteristicValue。validFor。startDateTime | 特性値が有効になる開始日時。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | productSpecCharacteristicです。productSpecCharacteristicValue。価値 | 特性の値。 データタイプ：文字列 | | productSpecCharacteristicです。productSpecCharacteristicValue。価値 | 必須。 特性の値。 データタイプ：文字列 | | productSpecCharacteristicです。validFor | 特性が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecCharacteristicです。validFor。endDateTime | 特性の終了日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS。例: `2025-01-31 09:35:43`。 デフォルト：空白の文字列 | | productSpecCharacteristicです。validFor。startDateTime | 特性の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS。例: `2025-01-31 09:35:43`。 デフォルト：空白の文字列 | | productSpecCharacteristicです。値タイプ | 特性の値タイプ (選択肢やメールなど)。複合型または非複合型にすることができます。 データタイプ：文字列 指定できる値: * 日付、住所 * 整数、日付/時刻 * Array.Integer * Array.Single Line Test * 1 行テスト * Array.Object * Array.Date * Array.Decimal * はい/いいえ * オブジェクト * Array.Datetime * チェックボックス * メール * 選択肢 {#tmf_prod_cat-POST-prodspec__ul_qrv_rrk_tfc} デフォルト：空白の文字列 | | 製品仕様関係 | この仕様と他の製品仕様との関係。 データタイプ：アレイ "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ] | | productSpecificationRelationship。身分証明書 | 関連仕様の ID。 データタイプ：文字列 デフォルト：空白の文字列 | | productSpecificationRelationship。種類 | productSpecificationRelationship パラメーターを使用する場合は必須です。関係のタイプ。 有効な値： * バンドル * composed_of {#tmf_prod_cat-POST-prodspec__ul_kjr_xnx_fsb} データタイプ：文字列 | | productSpecificationRelationship。validFor | 関係が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecificationRelationship。validFor。endDateTime | 関係の終了日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS。例: `2025-01-31 09:35:43`。 デフォルト：空白の文字列 | | productSpecificationRelationship。validFor。startDateTime | 関係の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS。例: `2025-01-31 09:35:43`。 デフォルト：空白の文字列 | | リソース仕様 | 必須です。この製品仕様に関連するリソース仕様。 データタイプ：オブジェクトのアレイ "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | resourceSpecification です。身分証明書 | 必須。リソース仕様の初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | resourceSpecification です。内部 ID | リソース仕様レコードの初期バージョン (sys_id)。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの initial_version フィールド。 | | resourceSpecification です。内部バージョン | リソース仕様のバージョン。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルのバージョンフィールド。 | | resourceSpecification です。名前 | リソース仕様の名前。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] | | resourceSpecification です。バージョン | リソース仕様の外部バージョン。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの external_version フィールド内。 | | サービス仕様 | この製品仕様に関連するサービス仕様のリスト。 データタイプ：オブジェクトのアレイ "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | serviceSpecificationです。身分証明書 | サービス仕様の初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | serviceSpecificationです。内部 ID | サービス仕様の初期バージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルの initial_version フィールド。 | | serviceSpecificationです。内部バージョン | サービス仕様のバージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルのバージョンフィールド。 | | serviceSpecificationです。名前 | サービス仕様の名前。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] | | serviceSpecificationです。バージョン | サービス仕様の外部バージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルの external_version フィールド。 | | validFor | 必須です。仕様が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor。endDateTime | 仕様の終了日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS。例: `2025-01-31 09:35:43`。 デフォルト：空白の文字列 | | validFor。startDateTime | 仕様の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS。例: `2025-01-31 09:35:43`。 デフォルト：空白の文字列 | | バージョン | 製品仕様の外部バージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルの external_version フィールド。 | [表 : 105. 要求本文パラメーター (JSON)] {#tmf_prod_cat-POST-prodspec__table_db1_q51_jsb} ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 106. 要求ヘッダー] {#tmf_prod_cat-POST-prodspec__table_ett_h3z_gsb} {#tmf_prod_cat-POST-prodspec__table_tzy_thy_ksb__entry__2} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 107. 応答ヘッダー] {#tmf_prod_cat-POST-prodspec__table_tzy_thy_ksb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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} | [表 : 108. ステータスコード] {#tmf_prod_cat-POST-prodspec__table_fbw_k3z_gsb} ### 応答本文のパラメーター {#tmf_prod_cat-POST-prodspec__entry__116} | 名前 | 説明 | |-|-| | description | 仕様の説明。 データタイプ：文字列 | | 外部システム | `TMF620` が追加された製品仕様の外部システム。 たとえば、外部システムが ABC の場合、値は `ABC-TMF620` です。 データタイプ:文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 デフォルト：空白の文字列 | | ID | 製品仕様の Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | internalId | 必須。 製品仕様のSys_idまたは内部 ID。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルの initial_version フィールド内。 | | internalVersion | 製品仕様のバージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルのバージョンフィールド。 | | バンドル | productSpecificationが単一の製品を表すか、製品のバンドルを表すかを示すフラグ。 有効な値： * true:製品仕様は製品バンドルであり、複数の製品が含まれています。 * false:製品仕様には単一の製品が含まれています。 {#tmf_prod_cat-POST-prodspec__ul_rry_rz4_4bc} データタイプ：ブーリアン デフォルト値：false | | 前回の更新 | 仕様が最後に更新された日付。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | ライフサイクルステータス | 製品仕様の現在のライフサイクルステータス。 可能な値： * 有効 * ドラフト * 非アクティブ {#tmf_prod_cat-POST-prodspec__ul_lj5_gg4_4bc} データタイプ：文字列 デフォルト：空白の文字列 | | name | 仕様の名前。 データタイプ：文字列 | | 製品仕様特性 | 仕様特性。 データタイプ：オブジェクトのアレイ "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] | | productSpecCharacteristicです。形容 | 特性の説明。 データタイプ：文字列 | | productSpecCharacteristicです。名前 | 特性の名前。 データタイプ：文字列 | | productSpecCharacteristicです。productSpecCharacteristicValue | 特性の可能な値のリスト。 データタイプ：オブジェクトのアレイ "productSpecCharacteristicValue": [ { "isDefault": Boolean, "isMandatory": Boolean, "validFor": {Object}, "value": "String" } ] | | productSpecCharacteristicです。productSpecCharacteristicValue。isDefault | 関連する特性値が特性のデフォルト値であるかどうかを示すフラグ。 可能な値： * true:デフォルト値。 * false:デフォルト値ではありません。 デフォルト値：false | | productSpecCharacteristicです。productSpecCharacteristicValue。必須か | 関連する特性値が特性の必須値であるかどうかを示すフラグ。 可能な値： * true:必須の値。 * false:必須の値ではありません。 デフォルト値：false | | productSpecCharacteristicです。productSpecCharacteristicValue。validFor | 特性が有効になった日時。 データタイプ: オブジェクト "validFor": { "startDateTime": "String" } | | productSpecCharacteristicです。productSpecCharacteristicValue。validFor。startDateTime | 特性値が有効になる開始日時。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | productSpecCharacteristicです。productSpecCharacteristicValue。価値 | 特性の値。 データタイプ：文字列 | | productSpecCharacteristicです。validFor | 特性が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecCharacteristicです。validFor。endDateTime | 特性の終了日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | productSpecCharacteristicです。validFor。startDateTime | 特性の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | productSpecCharacteristicです。値タイプ | 特性の値タイプ (選択肢やメールなど)。複合型または非複合型にすることができます。 データタイプ：文字列 指定できる値: * 日付、住所 * 整数、日付/時刻 * Array.Integer * Array.Single Line Test * 1 行テスト * Array.Object * Array.Date * Array.Decimal * はい/いいえ * オブジェクト * Array.Datetime * チェックボックス * メール * 選択肢 {#tmf_prod_cat-POST-prodspec__ul_khq_trk_tfc} | | 製品仕様関係 | この仕様と他の製品仕様との関係。 データタイプ：オブジェクトのアレイ "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ] | | productSpecificationRelationship。身分証明書 | 関連仕様のSys_id。 データタイプ：文字列 | | productSpecificationRelationship。種類 | 関係のタイプ。 データタイプ：文字列 | | productSpecificationRelationship。validFor | 関係が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | productSpecificationRelationship。validFor。endDateTime | 関係の終了日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | productSpecificationRelationship。validFor。startDateTime | 関係の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | リソース仕様 | この製品仕様に関連するリソース仕様のリスト。 データタイプ：オブジェクトのアレイ "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | resourceSpecification です。身分証明書 | リソース仕様の Sys_id ID または外部 ID。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | resourceSpecification です。内部 ID | リソース仕様レコードの初期バージョン (sys_id)。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの initial_version フィールド。 | | resourceSpecification です。内部バージョン | リソース仕様のバージョン。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルのバージョンフィールド。 | | resourceSpecification です。名前 | リソース仕様の名前。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] | | resourceSpecification です。バージョン | リソース仕様の外部バージョン。 データタイプ：文字列 テーブル:リソース仕様 \[sn_prd_pm_resource_specification\] テーブルの external_version フィールド内。 | | サービス仕様 | この製品仕様に関連するサービス仕様のリスト。 データタイプ：オブジェクトのアレイ "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] | | serviceSpecificationです。身分証明書 | サービス仕様の初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルのsys_idフィールドまたはexternal_idフィールド。 | | serviceSpecificationです。内部 ID | サービス仕様の初期バージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルの initial_version フィールド。 | | serviceSpecificationです。内部バージョン | サービス仕様のバージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルのバージョンフィールド。 | | serviceSpecificationです。名前 | サービス仕様の名前。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] | | serviceSpecificationです。バージョン | サービス仕様の外部バージョン。 データタイプ：文字列 テーブル:サービス仕様 \[sn_prd_pm_service_specification\] テーブルの external_version フィールド。 | | validFor | 仕様が有効な日付範囲。 データタイプ: オブジェクト "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor。endDateTime | 仕様の終了日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | validFor。startDateTime | 仕様の開始日。 データタイプ：文字列 形式:YYYY-MM-DD HH:mm:SS | | バージョン | 製品仕様の外部バージョン。 データタイプ：文字列 テーブル:製品仕様 \[sn_prd_pm_product_specification\] テーブルの external_version フィールド。 | [ ] この例では、指定した値で製品仕様レコードを作成します。 curl --location --request POST "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification" \ --header "Content-Type: application/json" \ --data-raw '{ "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6", "externalSystem": "Salesforce-TMF620", "name": "SD-WAN Service Package", "displayName": "SD-WAN Service Package v3", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "description": "SD WAN Service Package", "lastUpdate": "2027-10-11 06:58:12", "isBundle": true, "validFor": { "startDateTime": "2029-02-05", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [ { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "type": "Service", "validFor": { "startDateTime": "2025-01-24", "endDateTime": "" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "1", "numberSpecRelUpperLimit": "1" } }, { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "", "internalVersion": "2", "internalId": "39b627aa53702010cd6dddeeff7b1202", "type": "Service", "validFor": { "startDateTime": "2026-06-05", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "2", "numberSpecRelUpperLimit": "4" } }, { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "", "internalVersion": "2", "internalId": "a6514bd3534560102f18ddeeff7b1247", "type": "Service", "validFor": { "startDateTime": "2026-06-03", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "4", "numberSpecRelUpperLimit": "20" } } ], "resourceSpecification": [], "productSpecCharacteristic": [ { "productSpecCharacteristicValue": [ { "value": "1", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.25", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.01", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.5", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } } ], "name": "Down Time", "description": "Down Time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:36:15" } }, { "productSpecCharacteristicValue": [ { "value": "500 Mbps", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "5 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Bandwidth", "description": "Bandwidth", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:32:11" } }, { "productSpecCharacteristicValue": [ { "value": "4 hrs", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 hr", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Time to Restore (TTR)", "description": "Time to Restore (TTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:37:25" } }, { "productSpecCharacteristicValue": [ { "value": "1 hr", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "4 hrs", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Mean Time to Restore (MTR)", "description": "Mean Time to Restore (MTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:39:05" } }, { "productSpecCharacteristicValue": [ { "value": "No", "validFor": { "startDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "" } } ], "name": "Application Flow Backup", "description": "Application Flow Backup", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:30:39" } }, { "productSpecCharacteristicValue": [ { "value": "99.00", "validFor": { "startDateTime": "" } }, { "value": "99.50", "validFor": { "startDateTime": "" } }, { "value": "99.75", "validFor": { "startDateTime": "" } }, { "value": "99.99", "validFor": { "startDateTime": "" } } ], "name": "Up Time", "description": "Up time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:34:30" } }, { "productSpecCharacteristicValue": [ { "value": "No", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "Yes", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Application Encryption", "description": "Application Encryption", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:29:08" } } ], "status": "published" }' --user 'username':'password' 応答本文。 { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6", "externalSystem": "Salesforce-TMF620", "name": "SD-WAN Service Package", "displayName": "SD-WAN Service Package v3", "version": "", "internalVersion": "3", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "description": "SD WAN Service Package", "lastUpdate": "2027-10-11 06:58:12", "isBundle": true, "validFor": { "startDateTime": "2029-02-05", "endDateTime": "" }, "serviceSpecification": [], "productSpecificationRelationship": [ { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "type": "Service", "validFor": { "startDateTime": "2025-01-24", "endDateTime": "" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "1", "numberSpecRelUpperLimit": "1" } }, { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "", "internalVersion": "2", "internalId": "39b627aa53702010cd6dddeeff7b1202", "type": "Service", "validFor": { "startDateTime": "2026-06-05", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "2", "numberSpecRelUpperLimit": "4" } }, { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "", "internalVersion": "2", "internalId": "a6514bd3534560102f18ddeeff7b1247", "type": "Service", "validFor": { "startDateTime": "2026-06-03", "endDateTime": "2031-07-05" }, "relationshipType": "bundles", "ProdSpecRelationshipOption": { "numberSpecRelLowerLimit": "1", "numberSpecRelDefault": "4", "numberSpecRelUpperLimit": "20" } } ], "resourceSpecification": [], "productSpecCharacteristic": [ { "productSpecCharacteristicValue": [ { "value": "1", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.25", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.01", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "0.5", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } } ], "name": "Down Time", "description": "Down Time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:36:15" } }, { "productSpecCharacteristicValue": [ { "value": "500 Mbps", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "5 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 Gbps", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Bandwidth", "description": "Bandwidth", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:32:11" } }, { "productSpecCharacteristicValue": [ { "value": "4 hrs", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "1 hr", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Time to Restore (TTR)", "description": "Time to Restore (TTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:37:25" } }, { "productSpecCharacteristicValue": [ { "value": "1 hr", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "2 hrs", "isMandatory":true, "isDefault":false, "validFor": { "startDateTime": "" } }, { "value": "4 hrs", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Mean Time to Restore (MTR)", "description": "Mean Time to Restore (MTR)", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:39:05" } }, { "productSpecCharacteristicValue": [ { "value": "No", "validFor": { "startDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "" } } ], "name": "Application Flow Backup", "description": "Application Flow Backup", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:30:39" } }, { "productSpecCharacteristicValue": [ { "value": "99.00", "validFor": { "startDateTime": "" } }, { "value": "99.50", "validFor": { "startDateTime": "" } }, { "value": "99.75", "validFor": { "startDateTime": "" } }, { "value": "99.99", "validFor": { "startDateTime": "" } } ], "name": "Up Time", "description": "Up time", "valueType": "choice", "validFor": { "startDatetime": "2027-10-11 02:34:30" } }, { "productSpecCharacteristicValue": [ { "value": "No", "isMandatory":true, "isDefault":true, "validFor": { "startDateTime": "" } }, { "value": "Yes", "isMandatory":false, "isDefault":false, "validFor": { "startDateTime": "" } } ], "name": "Application Encryption", "description": "Application Encryption", "valueType": "yes_no", "validFor": { "startDatetime": "2027-10-11 02:29:08" } } ], "status": "published" }'