IBM Cloud Docs
バージョン管理

バージョン管理

現在の API バージョン: 2022-08-10

API 要求には、version=YYYY-MM-DD という形式で日付を取得する version パラメーターが必要です。 API 要求ごとに version パラメーターを送信します。

後方互換性のある方法で API を変更する場合、IBM は新規マイナー・バージョンをリリースします。 新規バージョンでの変更を利用するには、version パラメーターの値を新しい日付に変更します。 当該バージョンに更新する準備ができていない場合は、バージョン日付を変更しないでください。

バージョン日付の非推奨スケジュール

新しいバージョン日付がリリースされると、前のバージョン日付は 1 年続く非推奨期間に入ります。 廃止されたバージョンを使用する API 要求が、使用可能な最新バージョンに自動的に切り替えられる前に、非推奨ではないバージョンをサポートするためにコードをマイグレーションするのは 1 年後になります。

以下のタイムラインは、2019-06-04 バージョンの非推奨スケジュール中に発生する可能性がある事柄の例を示しています。

  • 2019-07-12 のバージョン日付がリリースされます。 これにより、1 年続く前の 2019-06-04 バージョン日付の非推奨期間が開始されます。
    • 非推奨バージョンの日付は、非推奨期間中も引き続き使用できます。
  • 非推奨期間中に新しいバージョン日付 (2020-05-10など) がリリースされます。
  • 2020 年 7 月 12 日に、2019-06-04 バージョン日付の非推奨期間が終了し、バージョン日付が廃止されます。
    • 2020 年 7 月 12 日より後の 2019-06-04 バージョン日付を引き続き使用する API 要求は、使用可能な最新バージョン日付の動作を使用するように自動的に変更されます。 この例では、使用可能な最新バージョンは 2020-05-10です。

バージョン日付

次の表では、バージョンの日付ごとにサービス動作の変更内容を示しています。 新しい日付のバージョンに切り替えると、それ以前のバージョンで導入された変更内容はすべてアクティブになります。

バージョンの日付 変更の要約 リタイヤメント日
2022-08-10
  • 正確度と信頼度スコアを向上させるための新しいモデルによるエンティティーの言語拡張。
  • バージョン 2 ロシア語エンティティー・タイプ・システム。
  • バージョン 2 スウェーデン語エンティティー・タイプ・システム。
  • 2022-04-07
  • バージョン 2 カテゴリー・タイプ・システムのバグの修正。
  • 2020-12-09
  • バージョン 2 英語エンティティー・タイプ・システム。
  • 2020-12-02
  • バージョン 2 韓国語エンティティー・タイプ・システム。
  • バージョン 2 スペイン語エンティティー・タイプ・システム。
  • 2020-08-01
  • デフォルトの分類におけるラベル名の標準化を目的とした分類の変更。
  • 2019-07-12
    非推奨
  • 正確度と信頼度スコアが向上した新しい英語のエンティティー・モデル。
  • 2021 年 8 月 1 日
    2019-06-04
    非推奨
  • カスタム・モデルを使用してエンティティー要求を行うと limit オプションが無視されるバグが修正されました。
  • 現在、すべてのエンティティー要求の limit のデフォルト値は、すべてのモデルで 50 です。
  • エンティティーの limit の最大値 250 は削除されました。
  • 2020 年 7 月 12 日
    2018-11-16
    非推奨
  • バージョン 2 イタリア語エンティティー・タイプ・システム。
  • 2020 年 7 月 12 日
    2018-09-21
    非推奨
  • バージョン 2 ポルトガル語エンティティー・タイプ・システム。
  • 2020 年 7 月 12 日
    2018-03-16
    非推奨
  • バージョン 2 フランス語エンティティー・タイプ・システム。
  • バージョン 2 ドイツ語エンティティー・タイプ・システム。
  • 2020 年 7 月 12 日
    2017-02-27
    非推奨
    基本バージョン。 2020 年 7 月 12 日