Classe google.script.url (API lato client)
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
google.script.url
è un codice JavaScript lato client asincrono
API che può interrogare gli URL per ottenere i parametri e il frammento URL correnti.
Questa API supporta google.script.history
tramite Google Cloud CLI
o tramite l'API Compute Engine. Può essere utilizzato solo nel contesto di un'app web che usa
IFRAME
Non è destinata all'utilizzo con barre laterali e finestre di dialogo in un componente aggiuntivo o
contesto container-script. Per ulteriori informazioni, consulta
guida all'uso del browser
la cronologia delle app nelle app web.
Metodi
Metodo | Tipo restituito | Breve descrizione |
getLocation(function) |
void |
Ottiene un oggetto posizione dell'URL e lo passa al callback specificato
personalizzata. |
Documentazione dettagliata
getLocation(function)
Recupera un oggetto posizione URL e lo passa al callback specificato
(come unico argomento).
Index.html
google.script.url.getLocation(function(location) {
console.log(location.parameters);
console.log(location.hash);
});
Parametri
Nome | Tipo | Descrizione |
function | Function | un server lato client
di callback di Google Cloud da eseguire, utilizzando
location oggetto come unico argomento.
|
Oggetto Location
La tabella seguente mostra esempi di elementi posizione che verranno specificati se la proprietà
È stata eseguita la query al seguente URL:
http://www.example.com?n=1&name=alice&n=2#headingAnchor
Campi |
location.hash |
Il valore stringa del frammento di URL dopo il carattere # ,
oppure una stringa vuota se non è presente alcun frammento di URL
headingAnchor
|
location.parameter |
Un oggetto di coppie chiave/valore che corrispondono alla richiesta dell'URL.
parametri. Per i parametri verrà restituito solo il primo valore
che hanno più valori. Se non sono presenti parametri,
un oggetto vuoto.
{"name": "alice", "n": "1"}
|
location.parameters |
Un oggetto simile a location.parameter , ma con
un array di valori per ogni chiave. Se non sono presenti parametri,
un oggetto vuoto.
{"name": ["alice"], "n": ["1", "2"]}
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 2025-07-26 UTC."],[[["\u003cp\u003e\u003ccode\u003egoogle.script.url\u003c/code\u003e is a client-side JavaScript API for querying URLs to get parameters and fragments within web apps.\u003c/p\u003e\n"],["\u003cp\u003eThis API works with \u003ccode\u003egoogle.script.history\u003c/code\u003e and requires the use of \u003ccode\u003eIFRAME\u003c/code\u003e in your web app.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetLocation()\u003c/code\u003e method retrieves a URL location object containing parameters and hash information, passing it to a callback function.\u003c/p\u003e\n"],["\u003cp\u003eThe location object provides access to URL components like hash, individual parameters, and all parameter values.\u003c/p\u003e\n"]]],[],null,["# Class google.script.url (Client-side API)\n\n`google.script.url` is an asynchronous client-side JavaScript\nAPI that can query URLs to obtain the current URL parameters and fragment.\nThis API supports the [`google.script.history`](/apps-script/guides/html/reference/history)\nAPI. It can only be used in the context of a web app that uses\n[`IFRAME`](/apps-script/reference/html/sandbox-mode#properties).\nIt is not intended for use with sidebars and dialogs in an add-on or\ncontainer-script context. For more information, see the\n[guide to using browser\nhistory in web apps](/apps-script/guides/web#web_apps_and_browser_history). \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------|-------------|------------------------------------------------------------------------------|\n| [getLocation(function)](#getLocation(Function)) | `void` | Gets a URL location object and passes it to the specified callback function. |\n\nDetailed documentation\n----------------------\n\n### `getLocation(function)`\n\nGets a [URL location object](#locationObject) and passes it to the specified callback\nfunction (as the only argument). \n\n### Index.html\n\n```html\ngoogle.script.url.getLocation(function(location) {\n console.log(location.parameters);\n console.log(location.hash);\n});\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|------------|------------|------------------------------------------------------------------------------------------------------------|\n| `function` | `Function` | a client-side callback function to run, using the [location object](#locationObject) as the only argument. |\n\n#### Location object\n\nThe following table shows examples of the location elements that would be specified if the following URL was queried: `http://www.example.com?n=1&name=alice&n=2#headingAnchor`\n\n| Fields ||\n|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `location.hash` | The string value of URL fragment after the `#` character, or an empty string if no URL fragment is present ``` headingAnchor ``` |\n| `location.parameter` | An object of key/value pairs that correspond to the URL request parameters. Only the first value will be returned for parameters that have multiple values. If no parameters are present, this will be an empty object. ``` {\"name\": \"alice\", \"n\": \"1\"} ``` |\n| `location.parameters` | An object similar to `location.parameter`, but with an array of values for each key. If no parameters are present, this will be an empty object. ``` {\"name\": [\"alice\"], \"n\": [\"1\", \"2\"]} ``` |\n\n*** ** * ** ***"]]