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

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

google.script.url é uma API JavaScript assíncrona do lado do cliente que pode consultar URLs para ver os fragmentos e parâmetros 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 com IFRAME. Ele não se destina ao uso em barras laterais e caixas de diálogo em um contexto de complemento ou script de contêiner. Para mais informações, consulte o guia para usar o histórico do navegador em apps da Web.

Métodos

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

Documentação detalhada

getLocation(function)

Recebe um objeto de local 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 a ser executada usando o objeto de local como o único argumento.

Objeto de local

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 não houver nenhum fragmento de URL

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 os parâmetros que tiverem vários valores. Se nenhum parâmetro estiver presente, um objeto 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, um objeto vazio.

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