Office のバージョンと要件セット
Office にはプラットフォームやバージョンが異なるものが数多くあり、それらは Office JavaScript API (Office.js) に含まれる API をすべてサポートしているわけではありません。 Windows 上の Office 2013 は、Office アドインをサポートしていた最も古いバージョンの Office でした。ユーザーがインストールした Office のバージョンを常に制御できるわけではありません。 この状況に対処するために、Office アプリケーションが Office アドインで必要な機能をサポートしているかどうかを判断するのに役立つ、要件セットと呼ばれるシステムを提供します。
注:
- Office は、Windows、ブラウザー、Mac、iPad などの複数のプラットフォームで実行されます。
- Office アプリケーションの例としては、Office 製品 (Excel、Word、PowerPoint、Outlook、OneNote など) があります。
- Office は、Microsoft 365 サブスクリプションまたは永続的ライセンスで利用できます。 永続的なバージョンは、ボリューム ライセンス契約または小売で利用できます。
- 要件セットは、、など、API メンバーの名前付きグループです。
Office のバージョンを確認する方法
使用している Office のバージョンを特定するには、Office アプリケーション内で [ファイル] メニューを選択し、[アカウント] を選択します。 Office のバージョンが [ 製品情報 ] セクションに表示されます。 たとえば、次のスクリーンショットは、Office バージョン 1802 (ビルド 9026.1000) を示しています。
注:
Office のバージョンがこれと異なる場合は、「 Outlook のバージョン に関するページ」または 「Office について: 使用している Office のバージョン 」を参照して、バージョンに関するこの情報を取得する方法を理解してください。
展開
アドインの展開方法は、さまざまなプラットフォームとクライアントでのアドインの可用性に影響する可能性があります。 展開オプションの詳細については、「 Office アドインの展開と発行」を参照してください。
Office 要件セットの可用性
Office アドインは、API 要件セットを使用して、Office アプリケーションが使用する必要がある API メンバーをサポートしているかどうかを判断できます。 要件セットのサポートは、Office アプリケーションと Office アプリケーションのバージョンによって異なります (前のセクション「Office のバージョンをチェックする方法」を参照してください)。
一部の Office アプリケーションには、独自の API 要件セットがあります。 たとえば、Excel API の最初の要件セットは ExcelApi 1.1
で、Word API の最初の要件セットは WordApi 1.1
でした。 それ以降、追加の API 機能を提供するため、複数の新しい ExcelApi 要件セットと WordApi 要件セットが追加されています。
さらに、アドイン コマンド (リボン機能拡張) やダイアログ ボックスを起動する機能 (ダイアログ API) など、他の機能が共通 API に追加されました。 アドイン コマンドと Dialog API 要件セットは、さまざまな Office アプリケーションが共通して共有する API セットの例です。
アドインは、アドインが実行されている Office アプリケーションのバージョンでサポートされている要件セットでのみ API を使用できます。 特定の Office アプリケーション バージョンで使用できる要件セットを正確に把握するには、次のアプリケーション固有の要件セットに関する記事を参照してください。
- Excel JavaScript API 要件セット (ExcelApi)
- OneNote JavaScript API 要件セット (OneNoteApi)
- Outlook JavaScript API 要件セット (メールボックス)
- PowerPoint JavaScript API 要件セット (PowerPointApi)
- Word JavaScript API 要件セット (WordApi)
一部の要件セットには、複数の Office アプリケーションで使用できる API が含まれています。 これらの要件セットの詳細については、次の記事を参照してください。
- Office の共通要件セット
- アドイン コマンドの要件セット
- デバイスアクセス許可サービス要件セット
- ダイアログ API の要件セット
- ダイアログ配信元の要件セット
- Identity API の要件セット
- 画像強制型変換要件セット
- キーボード ショートカットの要件セット
- 入れ子になったアプリ認証要件セット
- ブラウザー ウィンドウの要件セットを開く
- リボン API の要件セット
- 共有ランタイム要件のセット
要件セットのバージョン番号 ( ExcelApi 1.1
の "1.1" など) は、Office アプリケーションに対して相対的です。 特定の要件セットのバージョン番号 (たとえば、ExcelApi 1.1
) は、Office.js のバージョン番号や、他の Office アプリケーション (Word、Outlook など) の要件セットには対応していません。 さまざまな Office アプリケーションの要件セットは、異なるレートでリリースされます。 たとえば、ExcelApi 1.5
の方が WordApi 1.3
要件セットより前にリリースされました。
Office JavaScript API ライブラリ (Office.js) には、現在利用可能なすべての要件セットが含まれています。
ExcelApi 1.3
や WordApi 1.3
のような要件セットは存在しますが、Office.js 1.3
のような要件セットは存在しません。 Office.js の最新リリースは、コンテンツ配信ネットワーク (CDN) 経由で配信される単一の Office エンドポイントとして維持されます。 バージョン管理や下位互換性の処理方法など、Office.js CDN に関する詳細については、「Office JavaScript API について」を参照してください。
Office アプリケーションと要件セットを指定する
アドインで必要な Office アプリケーションと要件セットを指定するには、さまざまな方法があります。 詳細については、「Office アプリケーションと API 要件の指定」を参照してください。
関連項目
Office Add-ins