Classe google.script.url (API do lado do cliente)

google.script.url é uma API JavaScript assíncrona do lado do cliente que pode consultar URLs para receber os parâmetros e o fragmento de URL atuais. Essa API é compatível com a API google.script.history. Ele só pode ser usado no contexto de um app da Web que usa IFRAME. Ele não é indicado para uso com barras laterais e caixas de diálogo em um contexto de complemento ou container-script. Para mais informações, consulte o guia para usar o histórico de navegação em apps da Web.

Métodos

MétodoTipo de retornoBreve descrição
getLocation(function) void Recebe um objeto de localização do URL e o transmite para a função de callback especificada.

Documentação detalhada

getLocation(function)

Recebe um objeto de localização do URL e o transmite para a função de callback especificada (como o único argumento).

Index.html

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

Parâmetros

NomeTipoDescrição
functionFunctionUma função de callback do lado do cliente para ser executada usando o objeto de local como o único argumento.

Objeto de localização

A tabela a seguir mostra exemplos dos elementos de local que seriam especificados se o seguinte URL fosse consultado: http://www.example.com?n=1&name=alice&n=2#headingAnchor
Campos
location.hash

O valor da string do fragmento de URL após o caractere # ou uma string vazia se nenhum fragmento de URL estiver presente

headingAnchor
location.parameter

Um objeto de pares de chave-valor que correspondem aos parâmetros de solicitação de URL. Somente o primeiro valor será retornado para parâmetros que tenham vários valores. Se nenhum parâmetro estiver presente, o objeto estará vazio.

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

Um objeto semelhante a location.parameter, mas com uma matriz de valores para cada chave. Se nenhum parâmetro estiver presente, o objeto estará vazio.

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