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>
関連項目
Office Add-ins
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示