Office.Urls interface

アドインの JavaScript ランタイムの URL を取得します。

javascriptRuntimeUrl: string;

プロパティ値

注釈

API セット: メールボックス 1.14

最小アクセス許可レベル: 制限付き

適用可能な Outlook モード: Composeまたは読み取り

重要:

• 返される URL は、従来の Outlook on Windows がイベントベースのライセンス認証と統合スパム報告を処理するために使用する JavaScript ファイルの場所を指します。 これらの機能の詳細については、「イベントを使用してアドインをアクティブ化する」および「統合されたスパム報告アドインを実装する」を参照してください。

• Outlook on the web、Mac、および新しい Outlook on Windowsでは、この API はタスク ペインを実装するアドインではサポートされていません。 これらのクライアントでは、イベント ベースのライセンス認証または統合されたスパム報告を実装するアドインでのみ、API がサポートされます。

• アドインでアドインのみのマニフェストを使用している場合、返される URL は、型 javascript の RuntimeOverride 要素のresid値と一致します。 詳細については、「ランタイムの要素のオーバーライド」を参照してください。

• アドインで Microsoft 365 の統合マニフェストが使用されている場合、返される URL は "extensions.runtimes.code" オブジェクトの script プロパティの値と一致します。

例

// Get the value of the first parameter of the JavaScript runtime URL.
// For example, if the URL is https://wwww.contoso.com/training?key1=value1&key2=value2,
// the following function logs "First parameter value: value1" to the console.
const url = Office.context.urls.javascriptRuntimeUrl;
const regex = /=([^&]+)/;
console.log(`First parameter value: ${url.match(regex)[1]}`);