google.script.url
es una API de JavaScript asíncrona del cliente que puede consultar URLs para obtener los parámetros y el fragmento de URL actuales.
Esta API admite la API de google.script.history
. Solo se puede usar en el contexto de una app web que use IFRAME
.
No está diseñado para su uso con barras laterales y diálogos en un contexto de complementos o de secuencias de comandos de contenedor. Para obtener más información, consulta la guía para usar el historial del navegador en apps web.
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
getLocation(function) |
void |
Obtiene un objeto de ubicación de URL y lo pasa a la función de devolución de llamada especificada. |
Documentación detallada
getLocation(function)
Obtiene un objeto de ubicación de URL y lo pasa a la función de devolución de llamada especificada (como único argumento).
Index.html
google.script.url.getLocation(function(location) { console.log(location.parameters); console.log(location.hash); });
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
function | Function | ejecutar una función de devolución de llamada del cliente con el objeto de ubicación como único argumento. |
Objeto de ubicación
En la siguiente tabla, se muestran ejemplos de los elementos de ubicación que se especificarían si se consultara la siguiente URL:http://www.example.com?n=1&name=alice&n=2#headingAnchor
Campos | |
---|---|
location.hash |
El valor de string del fragmento de URL después del carácter headingAnchor |
location.parameter |
Un objeto de pares clave-valor que corresponde a los parámetros de solicitud de URL. Solo se mostrará el primer valor para los parámetros que tengan varios valores. Si no hay parámetros presentes, este será un objeto vacío. {"name": "alice", "n": "1"} |
location.parameters |
Un objeto similar a {"name": ["alice"], "n": ["1", "2"]} |