Excel JavaScript API の要件セット

  • [アーティクル]

要件セットは、API メンバーの名前付きグループです。 Office アドインでは、マニフェストで指定されている要件セットを使用するか、ランタイム チェックを使用して、Office アプリケーションがアドインに必要な API をサポートしているかどうかを判断します。 詳細については、「 Office のバージョンと要件セット」を参照してください。

要件セットの可用性

Excel アドインは、Windows での Office 2016 以降、Office on the web、Mac、および iPad など、複数のバージョンの Office で機能します。 次の表に、Excel 要件セット、サポートされている Office クライアント アプリケーション、および該当する場合はそれらのアプリケーションの 最小 ビルドまたはバージョンを示します。

注:

番号付きの要件セットまたは ExcelApiOnline のいずれかで API を使用するには、Office.js コンテンツ配信ネットワーク (CDN) で生産ライブラリを参照してください。

プレビューの API の使用に関する詳細については、記事「Excel JavaScript プレビュー API」を参照してください。

要件セット Windows での Office
- Microsoft 365 サブスクリプション
- リテール パーペチュアル Office 2016 以降		 Windows での Office
(ボリューム ライセンスの永続的)		 Office on Mac Office on iPad Office on the web
プレビュー 最新の Office バージョンを使用してプレビュー API を試してください ( Microsoft 365 Insider プログラムに参加する必要がある場合があります)。
ExcelApiOnline 該当なし 該当なし 該当なし 該当なし 最新 (要件セットのページを参照)
ExcelApi 1.17 バージョン 2302 (ビルド 16130.20332) 使用不可 16.70 16.70 サポート
ExcelApi 1.16 バージョン 2208 (ビルド 15601.20148) 使用不可 16.64 16.66 サポート
ExcelApi 1.15 バージョン 2202 (ビルド 14931.20132) 使用不可 16.58 16.59 サポート
ExcelApi 1.14 バージョン 2108 (ビルド 14326.20508) Office 2021: バージョン 2108 (ビルド 14326.20508) 16.52 16.53 サポート
ExcelApi 1.13 バージョン 2102 (ビルド 13801.20738) Office 2021: バージョン 2102 (ビルド 13801.20738) 16.50 16.50 サポート
ExcelApi 1.12 バージョン 2008 (ビルド13127.20408) Office 2021: バージョン 2008 (ビルド 13127.20408) 16.40 16.40 サポート
ExcelApi 1.11 バージョン 2002 (ビルド 12527.20470) Office 2021: バージョン 2002 (ビルド 12527.20470) 16.33 16.35 サポート
ExcelApi 1.10 バージョン 1907 (ビルド 11929.20306) Office 2021: バージョン 1907 (ビルド 11929.20306) 16.30 16.0 サポートされている
ExcelApi 1.9 バージョン 1903 (ビルド 11425.20204) Office 2021: バージョン 1903 (ビルド 11425.20204) 16.24 16.0 サポート
ExcelApi 1.8 バージョン 1808 (ビルド 10730.20102) Office 2021: バージョン 1808 (ビルド 10730.20102) 16.17 16.0 サポートされている
ExcelApi 1.7 バージョン 1801 (ビルド 9001.2171) Office 2019: バージョン 1801 (ビルド 9001.2171) 16.9 16.0 サポートされている
ExcelApi 1.6 バージョン 1704 (ビルド 8201.2001) Office 2019: バージョン 1704 (ビルド 8201.2001) 15.36 15.0 サポート
ExcelApi 1.5 バージョン 1703 (ビルド 8067.2070) Office 2019: バージョン 1703 (ビルド 8067.2070) 15.36 15.0 サポート
ExcelApi 1.4 バージョン 1701 (ビルド 7870.2024) Office 2019: バージョン 1701 (ビルド 7870.2024) 15.36 15.0 サポート
ExcelApi 1.3 バージョン 1608 (ビルド 7369.2055) Office 2019: バージョン 1608 (ビルド 7369.2055) 15.27 15.0 サポート
ExcelApi 1.2 バージョン 1601 (ビルド 6741.2088) Office 2019: バージョン 1601 (ビルド 6741.2088) 15.22 15.0 サポート
ExcelApi 1.1 バージョン 1509 (ビルド 4266.1001) Office 2016: バージョン 1509 (ビルド 4266.1001) 15.20 15.0 サポート

Office のバージョンとビルド番号

Office のバージョンとビルド番号の詳細については、次を参照してください。

実行時およびマニフェストで Excel 要件セットを使用する方法

注:

このセクションでは、Office バージョンと要件セット の概要、および Office アプリケーションと API 要件の指定 について理解していることを前提としています。

要件セットは、API メンバーの名前付きグループです。 Office アドインはランタイム チェックを実行できます。または、マニフェストで指定されている要件セットを使用して、Office アプリケーションがアドインに必要な API をサポートしているかどうかを確認できます。

実行時に要件セットのサポートを確認する

次のコード サンプルは、アドインが実行されている Office アプリケーションが指定された API の要件セットをサポートしているかどうかを確認する方法を示しています。

if (Office.context.requirements.isSetSupported('ExcelApi', '1.3')) {
  // Perform actions.
}
else {
  // Provide alternate flow/logic.
}

マニフェストで要件セットのサポートを定義する

アドインのマニフェストで Requirements 要素 を使用して、アドインをアクティブにするために必要な最小要件セットや API メソッド (またはその両方) を指定できます。 Office アプリケーションまたはプラットフォームが、マニフェストの Requirements 要素で指定されている要件セットまたは API メソッドをサポートしていない場合、アドインはそのアプリケーションまたはプラットフォームで実行されず、[マイ アドイン] に表示されるアドインのリストに表示されません。アドインが完全な機能のために特定の要件セットを必要とするが、要件セットをサポートしていないプラットフォームのユーザーにも価値を提供できる場合は、マニフェストの要件セットのサポートを定義する代わりに、上記のように実行時に要件サポートを確認することをお勧めします。

次のコード サンプルは、アドインが ExcelApi 要件セットのバージョン 1.3 以上をサポートする Office クライアント アプリケーションのすべてで読み込まれる必要があることを指定する、アドインのマニフェストの Requirements 要素を示しています。

<Requirements>
   <Sets DefaultMinVersion="1.3">
      <Set Name="ExcelApi" MinVersion="1.3"/>
   </Sets>
</Requirements>

関連項目