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); });
パラメータ
名前 | 型 | 説明 |
---|---|---|
function | Function | location オブジェクトを唯一の引数として使用し、実行するクライアント側のコールバック関数。 |
Location オブジェクト
次の表は、URL がクエリされた場合に指定される場所要素の例を示しています。http://www.example.com?n=1&name=alice&n=2#headingAnchor
フィールド | |
---|---|
location.hash |
headingAnchor |
location.parameter |
URL リクエスト パラメータに対応する Key-Value ペアのオブジェクト。複数の値を持つパラメータの場合、最初の値のみが返されます。パラメータが存在しない場合、これは空のオブジェクトになります。 {"name": "alice", "n": "1"} |
location.parameters |
{"name": ["alice"], "n": ["1", "2"]} |