Clase google.script.url (API del cliente)

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étodoTipo de datos que se muestraDescripció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

NombreTipoDescripción
functionFunctionejecutar 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 # o una string vacía si no hay un fragmento de URL presente

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 location.parameter, pero con un array de valores para cada clave. Si no hay parámetros presentes, este será un objeto vacío.

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