Office ライブラリの JavaScript API を Office コンテンツ配信ネットワーク (CDN) から参照するReferencing the JavaScript API for Office library from its content delivery network (CDN)

注意

この記事で説明する手順に加えて TypeScript を使用する場合は、 Intellisense を取得するために、プロジェクト フォルダーのルートからノード対応のシステム プロンプト (または git bash ウィンドウ) で次のコマンドを実行する必要があります。Node.js がインストールされている必要があります (npm を含む)。In addition to the steps described in this article, if you want to use TypeScript, then to get Intellisense you will need run the following command in a Node-enabled system prompt (or git bash window) from the root of your project folder. You must have Node.js installed (which includes npm).

npm install --save-dev @types/office-js

JavaScript API for Office ライブラリは、Office.js ファイルと関連するホスト アプリケーション固有の .js ファイル (Excel-15.js や Outlook-15.js など) で構成されています。The JavaScript API for Office library consists of the Office.js file and associated host application-specific .js files, such as Excel-15.js and Outlook-15.js.

最も簡単に API を参照する方法は、次に示す <script> をページの <head> タグに追加して、CDN を使用することです。The simplest way to reference the API is to use our CDN by adding the following <script> to your page's <head> tag:

<script src="https://appsforoffice.microsoft.com/lib/1/hosted/Office.js" type="text/javascript"></script>

CDN URL で office.js の前にある /1/ は、Office.js のバージョン 1 内で最新の増分リリースを指定します。JavaScript API for Office は旧バージョンとの互換性を維持しているため、最新リリースにおいてもバージョン 1 の時点で導入されていた API メンバーを引き続きサポートします。既存のプロジェクトをアップグレードする必要がある場合は、「JavaScript API for Office とマニフェスト スキーマ ファイルのバージョンを更新する」を参照してください。The /1/ in front of office.js in the CDN URL specifies the latest incremental release within version 1 of Office.js. Because the JavaScript API for Office maintains backward compatibility, the latest release will continue to support API members that were introduced earlier in version 1. If you need to upgrade an existing project, see Update the version of your JavaScript API for Office and manifest schema files.

AppSource から Office アドインを発行する場合は、この CDN の参照を使用する必要があります。ローカル参照は、内部シナリオ、開発シナリオ、デバッグ シナリオにのみ適用できます。If you plan to publish your Office Add-in from AppSource, you must use this CDN reference. Local references are only appropriate for internal, development, and debugging scenarios.

重要

Office ホスト アプリケーションのアドインを開発する場合は、ページの <head> セクションの中から JavaScript API for Office を参照します。これにより、すべての body 要素の前に API が完全に初期化されます。Office ホストでは、アクティブ化から 5 秒以内にアドインを初期化する必要があります。このしきい値内にアドインがアクティブにならない場合は、応答なしが宣言され、エラー メッセージがユーザーに表示されます。When you develop an add-in for any Office host application, reference the JavaScript API for Office from inside the <head> section of the page. This ensures that the API is fully initialized prior to any body elements. Office hosts require that add-ins initialize within 5 seconds of activation. If your add-in doesn't activate within this threshold, it will be declared unresponsive and an error message will be displayed to the user.

関連項目See also