次の方法で共有

Office アドイン マニフェスト

すべての Office アドインにはマニフェストがあります。 マニフェストには次の 2 種類があります。

  • アドインのみのマニフェスト: この種類のマニフェストは、Excel、OneNote、Outlook、PowerPoint、Project、Wordの運用アドインに使用できます。 アドインと Microsoft 365 プラットフォームの他の種類の拡張機能を組み合わせたアプリには使用できません。 その形式は XML です。
  • Microsoft 365 の統合マニフェスト: これは、Teams Apps のマニフェストとして長年使用されてきた JSON 形式のマニフェストの拡張バージョンです。 このマニフェストを使用するアドインは、他の種類の Microsoft 365 用アプリ 、つまり Microsoft 365 の拡張機能と組み合わせて、1 つのアプリとしてインストールできます。 この種類のマニフェストは、運用環境の Outlook アドインに使用できます。Excel、PowerPoint、Word アドインでプレビューできます。

注:

Microsoft 365 の統合マニフェストを使用する Office アドインを 直接 サポートするクライアントとプラットフォームについては、「Office アドイン と Microsoft 365 用統合アプリ マニフェスト」を参照してください。

この記事の残りの部分は、両方の種類のマニフェストに適用されます。

ヒント

Office アドインのマニフェスト ファイルには、エンド ユーザーが Office ドキュメントやアプリケーションと共にアドインをインストールして使用するときに、アドインをアクティブ化する方法が記述されています。

マニフェスト ファイルを使用すると、Office アドインで次の操作を実行できます。

  • ID、バージョン、説明、表示名、および既定のロケールを指定することで、アプリ自体について説明する。

  • アドインのブランド化に使用するイメージと、Office アプリ リボンでアドイン コマンドに使用する画像を指定する。

  • アドインを Office に統合する方法を指定する。アドインによって作成されるカスタム UI (リボンのボタンなど) の統合も含む。

  • コンテンツ アドインに必要な既定のサイズ、および Outlook アドインに必要な高さを指定する。

  • ドキュメントの読み取り、書き込みなど、Office アドインに必要なアクセス許可を宣言する。

注:

アドインを Microsoft Marketplace に 公開 し、Office エクスペリエンス内で利用できるようにする予定の場合は、 コマーシャル マーケットプレースの認定ポリシーに準拠していることを確認してください。 たとえば、検証に合格するには、アドインは、定義したメソッドをサポートするすべてのプラットフォーム全体で機能する必要があります (詳細については、セクション 1120.3 と「Office アドイン アプリケーションと可用性」のページを参照してください)。

ホストするための要件

アドイン コマンドに使用されるすべてのイメージ URI は、運用環境でのキャッシュをサポートする必要があります。 イメージをホストしているサーバーは、HTTP 応答でno-cache、no-store、または同様のオプションを指定するCache-Control ヘッダーを返すべきではありません。

アドイン内のコードまたはコンテンツ ファイルに対するすべての URL は 、SSL で保護された (HTTPS) である必要があります。 すべてのアドインのシナリオで厳密に求められるわけではないものの、アドインに対して HTTPS エンドポイントを使用することを強くお勧めします。 SSL で保護されている (HTTPS) のではないアドインは、使用中に、保護されていないコンテンツの警告やエラーを生成します。 アドインをOffice on the web実行する場合、または Microsoft Marketplace にアドインを発行する場合は、SSL で保護されている必要があります。 アドインが外部データやサービスにアクセスする場合、アドインを SSL で保護して送信中のデータを保護する必要があります。 自己署名証明書がローカル マシンで信頼されている限り、この証明書は開発とテストに使用できます。

Microsoft Marketplace に送信するためのベスト プラクティス

アドイン ID が有効で、一意の GUID であることを確認してください。 Web 上で、一意の GUID を作成するために使用できるさまざまな GUID ジェネレーター ツールを利用できます。

Microsoft Marketplace に送信されるアドインも、マニフェストにサポート URL を含める必要があります。 詳細については、「 Microsoft Marketplace に送信されたアプリとアドインの検証ポリシー」を参照してください。

アドイン ウィンドウで開くドメインの指定

Office on the webまたは新しい Outlook on Windows で実行している場合、作業ウィンドウは任意の URL に移動できます。 ただし、デスクトップ プラットフォームでは、アドインが (マニフェスト ファイルで指定されているように) スタート ページをホストするドメイン以外のドメインの URL に移動しようとすると、その URL は Office アプリケーションのアドイン ウィンドウの外側の新しいブラウザー ウィンドウで開きます。

この (デスクトップ Office) の動作をオーバーライドするには、マニフェストのアドイン ウィンドウで開く各ドメインを指定します。 アドインがこの一覧にあるドメインの URL に移動しようとすると、Office on the web とデスクトップの Office の両方の作業ウィンドウで開きます。 この一覧にない URL に移動しようとすると、その URL はデスクトップの Office 新しいブラウザー ウィンドウ (アドイン ウィンドウとは別のウィンドウ) で開きます。

注:

この動作に対する例外は 2 つあります。

  • これは、アドインのルート ウィンドウに対してのみ適用されます。 アドイン ページに iframe が埋め込まれている場合、iframe は、デスクトップ Office でも、マニフェストに一覧表示されているかどうかに関係なく、任意の URL に転送できます。
  • displayDialogAsync API を使用してダイアログを開くと、メソッドに渡される URL はアドインと同じドメインに存在する必要がありますが、ダイアログは、マニフェストに表示されているかどうかに関係なく、デスクトップ Office でも任意の URL に転送できます。

Office.js API 呼び出しが行われるドメインを指定する

アドインは、マニフェスト ファイルで参照されているアドインのドメインから Office.js API 呼び出しを行うことができます。 アドイン内に、Office.js API にアクセスする必要がある他の iframe がある場合は、そのソース URL のドメインをマニフェスト ファイルに追加します。 マニフェストに一覧にないソースを持つ iframe が Office.js API 呼び出しを試行した場合、アドインは アクセス許可拒否エラーを受け取ります。

関連項目

  • Last updated on