PowerPoint JavaScript API の要件セット

[アーティクル]
11/13/2024

要件セットは、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.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 要件セットを使用する方法

注:

このセクションでは、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 の要件セット」をご覧ください。

次の方法で共有