次の方法で共有


PowerPoint JavaScript API の要件セット

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

次の表に、PowerPoint要件セット、サポートされている Office クライアント アプリケーション、該当する場合はそれらのアプリケーションの 最小 ビルドまたはバージョンを示します。

要件セット Office on the web Windows での Office
  • Microsoft 365 サブスクリプション
  • 小売パーペチュアル
Windows での Office
  • ボリューム ライセンスの永続的
Office on Mac Office on iPad
プレビュー 最新の Office バージョンを使用してプレビュー API を試してください ( Microsoft 365 Insider プログラムに参加する必要がある場合があります)。
PowerPointApi 1.7 サポート 近日対応予定 使用不可 近日対応予定 使用不可
PowerPointApi 1.6 サポート バージョン 2410 (ビルド 18129.20030) 使用不可 バージョン 16.90 (24101387) 使用不可
PowerPointApi 1.5 サポート バージョン 2208 (ビルド 15601.20230) Office 2024: バージョン 2208 (ビルド 15601.20230) バージョン 16.64 (22080400) 使用不可
PowerPointApi 1.4 サポート バージョン 2207 (ビルド 15330.20122) Office 2024: バージョン 2207 (ビルド 15330.20122) バージョン 16.62 (22061100) 使用不可
PowerPointApi 1.3 サポート バージョン 2111 (ビルド 14701.20060) Office 2024: バージョン 2111 (ビルド 14701.20060) バージョン 16.55 (21111400) 使用不可
PowerPointApi 1.2 サポート バージョン 2011 (ビルド 13426.20184) Office 2021: バージョン 2011 (ビルド 13426.20184) バージョン 16.43 (20110804) 使用不可
PowerPointApi 1.1 サポート バージョン 1810 (ビルド 11001.20074) Office 2021: バージョン 1810 (ビルド 11001.20074) バージョン 16.19 (18110915) バージョン 2.17

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

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

PowerPoint JavaScript API 1.1

PowerPoint JavaScript API 1.1 には、新しいプレゼンテーションを作成するための 1 つの API が含まれます。 API の詳細については、「プレゼンテーションを作成する」を参照してください。

PowerPoint JavaScript API 1.2

PowerPoint JavaScript API 1.2 では、別の PowerPoint プレゼンテーションのスライドを現在のプレゼンテーションに挿入したり、スライドを削除したりするためのサポートを追加します。 API の詳細については、「PowerPoint プレゼンテーションのスライドの挿入と削除」を参照してください。

PowerPoint JavaScript API 1.3

PowerPoint JavaScript API 1.3 は、スライドの追加と削除のサポートを追加します。 また、アドインでカスタム メタデータ タグを適用することもできます。 API の詳細については、「PowerPoint でのスライドの追加と削除」および「PowerPoint でのプレゼンテーション、スライド、図形のカスタム タグの使用」を参照してください。

PowerPoint JavaScript API 1.4

PowerPoint JavaScript API 1.4 では、図形の追加、移動、サイズ設定、書式設定、削除に関する追加のサポートが追加されます。 これらの API の使用方法の詳細については、「 図形の操作」を参照してください。

PowerPoint JavaScript API 1.5

PowerPoint JavaScript API 1.5 には、プレゼンテーション内の既存のハイパーリンクを取得および管理するための API が含まれています。 詳細については、「 PowerPoint JavaScript API 要件セット 1.5」を参照してください。

PowerPoint JavaScript API 1.6

PowerPoint JavaScript API 1.6 には、プレゼンテーション内のスライド、テキスト範囲、図形を選択するための API が含まれています。 詳細については、「 PowerPoint JavaScript API 要件セット 1.6」を参照してください。

PowerPoint JavaScript API 1.7

JavaScript API 1.7 PowerPointには、プレゼンテーション内でカスタム プロパティとドキュメント プロパティを管理するための API が含まれています。 詳細については、「 PowerPoint JavaScript API 要件セット 1.7」を参照してください。

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

注:

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

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

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

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

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

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

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

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

<Requirements>
   <Sets DefaultMinVersion="1.1">
      <Set Name="PowerPointApi" MinVersion="1.1"/>
   </Sets>
</Requirements>

Office 共通 API の要件セット

PowerPoint のほとんどのアドイン機能は、共通の API セットから取得されます。 共通 API の要件セットの詳細については、「Office 共通 API の要件セット」をご覧ください。

関連項目