# 複数のバージョンでの作業

API Contracts を使用すると、同じ API コントラクトの複数のバージョンを管理できるため、新しいバージョンで変更を準備している間も、公開済みのバージョンを安定した状態に保つことができます。

* 既存の AP Iバージョンを本番環境で維持しつつ、画期的な変更を新しいバージョンに導入できます。
* 1 つの場所から公開されたバージョンを追跡および管理します。
* 既存のバージョンに影響を与えることなく、API の変更作業を実行します。

新しいバージョンを作成すると、すべてのコンテンツが新しいバージョンにコピーされます。これにより、以前のバージョンに影響を与えることなく、最新バージョンを個別に更新できます。

最新バージョンのみ編集可能であり、新しいバージョンは最新バージョンからのみ作成できます。以前のバージョンは読み取り専用です。

API Contracts ホームページには、所有するすべての API と共有する API の全バージョンが表示されます。![API Contracts のホームページ。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/api-designer-homepage.png)

## 新しいAPIバージョンの作成

既存のAPI定義の新しいバージョンを作成

情報メモ

注意:

新しいバージョンは、最新バージョンからのみ作成できます。以前のバージョンは読み取り専用であり、編集または新しいバージョンの作成に使用することはできません。

APIの所有者か、少なくとも1つのAPIバージョンのエディターであること。

1. ホームページで、新しいバージョンを作成するAPIに移動します。

   必要であればリストを名前でフィルタリングします。
2. 最新バージョンを開いて [プレビュー] を表示し、次に [新しいバージョンを作成] をクリックします。

   ![Contacts API と \[新しいバージョンを作成\] ボタンの表示。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/publish_version.png)
3. 新しいバージョンを入力します。
4. [Create] (作成)をクリックします。

新しいバージョンの API が最新バージョンと同じコンテンツで作成されます。 デフォルトではモックとドキュメンテーションが無効になっています。

## Qlik Catalog への API バージョンの公開

コラボレーターが Qlik Catalog で見つけられるように、API コントラクトのバージョンを Qlik スペースに公開します。

APIの所有者またはAPIバージョンの編集者である必要があります。

バージョンを公開すると、コントラクト バージョンは API Contracts で不変かつ読み取り専用になります。変更を加えるには、最新バージョンから新しいバージョンを作成し、その新しいバージョンで作業を続行してください。

1. ホームページで、公開するバージョンをクリックして [プレビュー] を開き、次に [公開] をクリックします。

   ![Contacts API と \[公開\] ボタンの表示。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/publish_version.png)
2. 公開ダイアログ ボックスで、バージョンを公開する Qlik スペースを選択します。
3. バージョン プレビューを確認し、公開メモを入力します。
4. [公開] をクリックします。

選択したバージョンは、選択した Qlik スペースに公開され、API Contracts で読み取り専用になります。コントラクトを再度編集する必要がある場合は、まず新しいバージョンを作成してください。

## APIバージョンの削除

APIの所有者か編集者であること。

1. ホームページで、削除したいバージョンの横にある![メニュー](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png)ボタンをクリックし、[Delete] (削除)をクリックします。
2. [Delete] (削除)をクリックして確定します。

選択されたバージョンで削除されます。API全体を削除する場合は、それぞれのバージョンを削除する必要があります。

## バージョンコンテンツのインポート

既存のコントラクトからコンテンツを API バージョンにインポートし、現在のコンテンツを置き換えるか、統合します。

APIの所有者またはAPIバージョンの編集者である必要があります。

この機能を使用すると、新しいバージョンを作成せずに外部のコントラクトファイルからバージョンを更新できます。インポート中もバージョン識別子は保持されます。

これは次とは異なりますAPI Contracts で新しい API を作成する[定義のインポート](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/APIDesigner/ImportingDefinition.htm "既存の API 定義を API Contracts にインポートします。")。

1. 更新対象となるバージョンの[Import version content] (バージョンコンテンツのインポート)を開きます。

   この操作は読み取り専用バージョンでは利用できません。

   この操作には、次の場所からアクセスできます。
   * ホームページで、バージョンの横にある ![メニュー](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) をクリックし、 [バージョン コンテンツのインポート] をクリックします。

     ![メニューボタンの\[Import version content\] (バージョンコンテンツのインポート)オプション。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-2.png)
   * バージョンの [プレビュー] で、![メニュー](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) > [バージョン コンテンツのインポート] をクリックします。

     ![バージョン詳細ビュー](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-3.png)
   * バージョンエディターで、[Edit] (編集) > [Import version content] (バージョンコンテンツのインポート)をクリックします。

     ![バージョンエディターの\[Import version content\] (バージョンコンテンツのインポート)オプション。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content.png)
2. インポートするコントラクトの形式とソースを選択します。

   コントラクトは、ローカルファイル、URL、またはダイアログボックスに直接貼り付けたテキストからインポートできます。
3. [Behavior] (動作)で、インポートしたコンテンツの適用方法を選択します。
   * 置換: 現在のすべてのコンテンツをインポートしたコントラクトで上書きします。API名、バージョン識別子、仕様バージョンは保持されます。
   * マージ: インポートしたコンテンツを既存のバージョンコンテンツと統合します。API名とバージョン識別子は保持されます。インポートしたエレメントが既存のエレメントと同じ名前を持つ場合、そのエレメントは\_mergeサフィックスを付けて名前が変更されます(例: User\_merge)。重複するベースURLおよびメディアタイプはスキップされます。

   ![\[Import version content\] (バージョンコンテンツをインポート)ダイアログボックス。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-dialobox.png)
4. [Import] (インポート)をクリックします。

更新されたコンテンツが適用された状態で、バージョンエディターが開きます。