悪意のある HTML や JavaScript の配信からユーザーを保護するために、Apps Script は iframe を使用して、HTML サービス ウェブアプリや Google ドキュメント、スプレッドシート、フォームのカスタム ユーザー インターフェースをサンドボックス化します。(HTML サービスは、メールの本文を生成する場合など、他の状況でサンドボックスを使用しません)。サンドボックスでは、クライアントサイド コードに制限が適用されます。
サンドボックス モード
IFRAME
を除くすべてのサンドボックス モードは廃止されました。古いサンドボックス モードを使用しているアプリは、新しい IFRAME
モードを自動的に使用します。古いモード(NATIVE
と EMULATED
)を使用して開発されたスクリプトがある場合は、移行手順に沿って、IFRAME
モードで正常に機能するようにする必要があります。
setSandboxMode
メソッドを呼び出しても効果がなくなりました。
IFRAME モードの制限
IFRAME
サンドボックス モードは、HTML5 の iframe サンドボックス化機能に基づいており、次のキーワードを使用します。
allow-same-origin
allow-forms
allow-scripts
allow-popups
allow-downloads
allow-modals
allow-popups-to-escape-sandbox
allow-top-navigation-by-user-activation
- この属性は、スタンドアロン スクリプト プロジェクトでのみ設定されます。
allow-top-navigation
キーワードはコンテンツが最上位のブラウジング コンテキストに移動できるようにするもので、制限されており、サンドボックスの属性として設定されません。スクリプトをリダイレクトする必要がある場合は、ユーザーが操作できるリンクまたはボタンを追加します。
リンク ターゲット属性を設定する
IFRAME
モードでは、リンク ターゲット属性を _top
または _blank
に設定する必要があります。
Code.js
function doGet() {
var template = HtmlService.createTemplateFromFile('top');
return template.evaluate().setSandboxMode(HtmlService.SandboxMode.IFRAME);
}
top.html
<!DOCTYPE html>
<html>
<body>
<div>
<a href="http://google.com" target="_top">Click Me!</a>
</div>
</body>
</html>
この属性は、包含するウェブページの head セクション内の <base>
タグを使用してオーバーライドすることもできます。
<!DOCTYPE html>
<html>
<head>
<base target="_top">
</head>
<body>
<div>
<a href="http://google.com">Click Me!</a>
</div>
</body>
</html>
アクティブなコンテンツには HTTPS が必要です
スクリプト、外部スタイルシート、XmlHttpRequest などの「アクティブ」コンテンツは、HTTP ではなく HTTPS 経由で読み込む必要があります。