クラス google.script.url(クライアント サイド API)

google.script.url は、クライアントサイドの非同期 JavaScript API です。この API を使用すると、URL に対してクエリを実行して、現在の URL パラメータとフラグメントを取得できます。 この API は google.script.history API をサポートしています。IFRAME を使用するウェブアプリのコンテキストでのみ使用できます。アドオンまたはコンテナ スクリプトのコンテキストでサイドバーやダイアログで使用することは想定されていません。詳細については、ウェブアプリでのブラウザの履歴の使用に関するガイドをご覧ください。

Methods

メソッド戻り値の型概要
getLocation(function) void URL 位置情報オブジェクトを取得し、指定されたコールバック関数に渡します。

詳細なドキュメント

getLocation(function)

URL 位置情報オブジェクトを取得し、指定されたコールバック関数に(唯一の引数として)渡します。

Index.html

google.script.url.getLocation(function(location) {
  console.log(location.parameters);
  console.log(location.hash);
});

パラメータ

名前説明
functionFunctionlocation オブジェクトを唯一の引数として使用し、実行するクライアント側のコールバック関数。

Location オブジェクト

次の表は、URL がクエリされた場合に指定される場所要素の例を示しています。http://www.example.com?n=1&name=alice&n=2#headingAnchor
フィールド
location.hash

# 文字の後の URL フラグメントの文字列値。URL フラグメントが存在しない場合は空の文字列。

headingAnchor
location.parameter

URL リクエスト パラメータに対応する Key-Value ペアのオブジェクト。複数の値を持つパラメータの場合、最初の値のみが返されます。パラメータが存在しない場合、これは空のオブジェクトになります。

{"name": "alice", "n": "1"}
location.parameters

location.parameter に似ていますが、各キーに値の配列があります。パラメータが存在しない場合、これは空のオブジェクトになります。

{"name": ["alice"], "n": ["1", "2"]}