Klasa google.script.url (interfejs API po stronie klienta)

google.script.url to asynchroniczny interfejs API JavaScript po stronie klienta, który może wysyłać zapytania do adresów URL, aby uzyskać bieżące parametry i fragment kodu. Ten interfejs API obsługuje interfejs google.script.history API. Można jej używać tylko w kontekście aplikacji internetowej, która korzysta z IFRAME. Nie należy go używać z paskami bocznymi ani oknami w kontekście dodatku lub kontenera-kontenera. Więcej informacji znajdziesz w przewodniku po korzystaniu z historii przeglądarki w aplikacjach internetowych.

Metody

MetodaZwracany typKrótki opis
getLocation(function) void Pobiera obiekt lokalizacji URL i przekazuje go do określonej funkcji wywołania zwrotnego.

Szczegółowa dokumentacja

getLocation(function)

Pobiera obiekt lokalizacji URL i przekazuje go do określonej funkcji wywołania zwrotnego (jako jedyny argument).

Indeks.html

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

Parametry

NazwaTypOpis
functionFunctionFunkcja wywołania zwrotnego po stronie klienta, w której jedynym obiektem jest obiekt lokalizacji.

Obiekt lokalizacji

Poniższa tabela zawiera przykłady elementów lokalizacji, które byłyby określone, gdyby zapytanie miało ten adres URL: http://www.example.com?n=1&name=alice&n=2#headingAnchor
Pola
location.hash

Wartość ciągu przypisana do fragmentu adresu URL po znaku # lub pusta wartość, jeśli brakuje fragmentu adresu URL

headingAnchor
location.parameter

Obiekt zawierający pary klucz-wartość odpowiadający parametrom żądania adresu URL. W przypadku parametrów, które mają wiele wartości, zostanie zwrócona tylko pierwsza wartość. Jeśli nie ma żadnych parametrów, obiekt będzie pusty.

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

Obiekt podobny do location.parameter, ale z tablicą wartości każdego klucza. Jeśli nie ma żadnych parametrów, obiekt będzie pusty.

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