Aplikacje internetowe

Jeśli tworzysz interfejs użytkownika dla skryptu, możesz go opublikować jako aplikację internetową. Na przykład skrypt, który pozwala użytkownikom planować spotkania z członkami zespołu pomocy, najlepiej prezentować jako aplikację internetową, aby użytkownicy mogli uzyskać do niej dostęp bezpośrednio z przeglądarki.

Zarówno samodzielne skrypty, jak i skrypty powiązane z aplikacją mogą zostać przekształcone w aplikacje internetowe, o ile spełniają poniższe wymagania.

Wymagania dotyczące aplikacji internetowych

Skrypt może zostać opublikowany jako aplikacja internetowa, jeśli spełnia te wymagania:

• zawiera funkcję doGet(e) lub doPost(e);
• Funkcja zwraca obiekt usługi HTML HtmlOutput lub obiekt usługi dotyczącej treści TextOutput.

Parametry żądania

Gdy użytkownik odwiedza aplikację lub program wysyła do niej żądanie HTTP GET, skrypt Apps Script uruchamia funkcję doGet(e). Gdy program wysyła do aplikacji żądanie HTTPPOST, skrypt Apps uruchamia się zamiast doPost(e). W obu przypadkach argument ereprezentuje parametr zdarzenia, który może zawierać informacje o dowolnych parametrach żądania. Strukturę obiektu zdarzenia przedstawia tabela poniżej:

Pola
e.queryString	Wartość ciągu zapytania w adresie URL lub null, jeśli ciąg zapytania nie jest określony name=alice&n=1&n=2
e.parameter	Obiekt par klucz-wartość odpowiadających parametrom żądania. W przypadku parametrów, które mają wiele wartości, zwracana jest tylko pierwsza wartość. {"name": "alice", "n": "1"}
e.parameters	Obiekt podobny do e.parameter, ale z tablicą wartości dla każdego klucza {"name": ["alice"], "n": ["1", "2"]}
e.pathInfo	Ścieżka adresu URL po /exec lub /dev. Jeśli np. ścieżka URL kończy się na /exec/hello, informacja o ścieżce to hello.
e.contextPath	Nieużywany, zawsze pusty ciąg.
e.contentLength	Długość treści żądania w przypadku żądań POST lub -1 w przypadku żądań GET 332
e.postData.length	Taka sama jak w hotelu e.contentLength 332
e.postData.type	Typ MIME treści żądania POST. text/csv
e.postData.contents	Treść treści żądania POST Alice,21
e.postData.name	Zawsze wartość „postData” postData

Możesz np. przekazywać takie parametry jak username i age do adresu URL w ten sposób:

https://script.google.com/.../exec?username=jsmith&age=21

Następnie możesz wyświetlić parametry w ten sposób:

function doGet(e) {
  var params = JSON.stringify(e);
  return ContentService.createTextOutput(params).setMimeType(ContentService.MimeType.JSON);
}

W przykładzie powyżej doGet(e) zwraca te dane wyjściowe:

{
  "queryString": "username=jsmith&age=21",
  "parameter": {
    "username": "jsmith",
    "age": "21"
  },
  "contextPath": "",
  "parameters": {
    "username": [
      "jsmith"
    ],
    "age": [
      "21"
    ]
  },
  "contentLength": -1
}

Ostrzeżenie: te nazwy parametrów są zarezerwowane przez system i nie należy ich używać w parametrach adresu URL ani w treściach żądań POST:

• c
• sid

Używanie tych parametrów może spowodować odpowiedź HTTP 405 z komunikatem o błędzie „Przepraszamy, ale żądany plik nie istnieje”. W miarę możliwości zaktualizuj skrypt, aby używać innych nazw parametrów.

Wdrażanie skryptu jako aplikacji internetowej

Aby wdrożyć skrypt jako aplikację internetową:

1. W prawym górnym rogu projektu skryptu kliknij Wdróż > Nowe wdrożenie.
2. Obok pozycji „Wybierz typ” kliknij Włącz typy wdrożenia  > Aplikacja internetowa.
3. W polach w sekcji „Konfiguracja wdrożenia” podaj informacje o aplikacji internetowej.
4. Kliknij Wdróż.

Adres URL aplikacji internetowej możesz udostępnić osobom, które mają korzystać z Twojej aplikacji, pod warunkiem że przyznasz im dostęp.

Uwaga: aplikacje internetowe wdrożone w jednej domenie przestają działać, jeśli ich własność zmieni się na dysk współdzielony lub konto w innej domenie. Można to naprawić, prosząc nowego właściciela lub współpracownika o wdrożenie aplikacji internetowej w nowej domenie. Jeśli aplikacja internetowa zostanie przeniesiona z powrotem do pierwotnej domeny, zacznie działać w tej domenie bez konieczności ponownego wdrożenia.

Testowanie wdrożenia aplikacji internetowej

Aby przetestować skrypt jako aplikację internetową:

1. W prawym górnym rogu projektu skryptu kliknij Wdróż > Testuj wdrożenia.
2. Obok opcji „Wybierz typ” kliknij Włącz typy wdrożenia > Aplikacja internetowa.
3. Pod adresem URL aplikacji internetowej kliknij Kopiuj.

4. Wklej adres URL w przeglądarce i przetestuj aplikację internetową.

   Ten adres URL kończy się na /dev i mogą go otwierać tylko użytkownicy z uprawnieniami do edycji skryptu. Ta instancja aplikacji zawsze uruchamia ostatnio zapisany kod i służy tylko do testowania podczas tworzenia aplikacji.

Ostrzeżenie: podczas wdrażania aplikacji internetowych do uruchamiania jako deweloper należy zachować szczególną ostrożność podczas obsługi tokenów OAuth uzyskanych za pomocą metody ScriptApp.getOAuthToken(). Te tokeny mogą przyznawać innym aplikacjom dostęp do Twoich danych – nigdy nie przekazuj ich klientowi.

Uprawnienia

Uprawnienia aplikacji internetowej różnią się w zależności od tego, jak chcesz ją uruchomić:

• Uruchom aplikację jako ja – w tym przypadku skrypt zawsze działa jako właściciel skryptu, niezależnie od tego, kto uzyskuje dostęp do aplikacji internetowej.
• Uruchomienie aplikacji jako użytkownik korzystający z aplikacji internetowej – w tym przypadku skrypt jest uruchamiany pod tożsamością aktywnego użytkownika korzystającego z aplikacji internetowej. Dzięki tym uprawnieniom aplikacja internetowa wyświetla adres e-mail właściciela skryptu, gdy użytkownik autoryzuje dostęp.

Ostrzeżenie: aby zapobiec nadużyciom, Apps Script nakłada limity na częstotliwość, z jaką nowi użytkownicy mogą autoryzować aplikację internetową, która działa jako użytkownik. Te limity zależą m.in. od tego, czy konto publikujące należy do domeny .

Uwaga: możesz współpracować nad aplikacjami internetowymi za pomocą dysku współdzielonego. Gdy aplikacja internetowa na dysku współdzielonym zostanie wdrożona, wybór opcji „Uruchom jako” spowoduje, że aplikacja będzie działać z uprawnieniami użytkownika, który ją wdrożył (ponieważ nie ma właściciela skryptu).

Wstawianie aplikacji internetowej w Witrynach Google

Ostrzeżenie: wbudowane aplikacje internetowe są nadal objęte uprawnieniami dostępu, aby zapobiec ich złośliwemu wykorzystaniu. Jeśli wbudowana aplikacja internetowa nie działa, sprawdź, czy uprawnienia ustawione przez właściciela aplikacji internetowej i administratora domeny zezwalają na jej użycie.

Aby osadzić aplikację internetową w Witrynach Google, musisz ją najpierw wdrażać. Potrzebujesz też adresu URL wdrożonej aplikacji z okna Deploy.

Aby osadzić aplikację internetową na stronie Witryny:

1. Otwórz stronę Witryny, na której chcesz dodać aplikację internetową.
2. Kliknij Wstaw > Umieść URL.
3. Wklej adres URL aplikacji internetowej, a potem kliknij DODAJ.

Aplikacja internetowa pojawi się w ramce w podglądzie strony. Po opublikowaniu strony użytkownicy witryny mogą musieć autoryzować aplikację internetową, zanim będzie ona mogła normalnie działać. Nieautoryzowane aplikacje internetowe wyświetlają użytkownikowi prośby o autoryzację.

Aplikacje internetowe i historia przeglądarki

Aplikacja internetowa Apps Script może symulować aplikację wielostronicową lub aplikację z interfejsem użytkownika dynamicznym, sterowanym za pomocą parametrów URL. Aby to zrobić, możesz zdefiniować obiekt stanu, który będzie reprezentować interfejs użytkownika lub stronę aplikacji, i przesyłać stan do historii przeglądarki, gdy użytkownik będzie się przemieszczać po aplikacji. Możesz też nasłuchiwać zdarzeń historii, aby Twoja aplikacja internetowa wyświetlała prawidłowy interfejs, gdy użytkownik będzie się przemieszczać między stronami za pomocą przycisków przeglądarki. Wysyłając zapytanie o parametry adresu URL w momencie wczytywania, możesz umożliwić aplikacji dynamiczne tworzenie interfejsu użytkownika na podstawie tych parametrów, co pozwoli użytkownikowi uruchomić aplikację w określonym stanie.

Aby ułatwić tworzenie aplikacji internetowych powiązanych z historią przeglądania, Apps Script udostępnia 2 asynchroniczne interfejsy API JavaScript po stronie klienta:

• google.script.historyzawiera metody umożliwiające dynamiczną reakcję na zmiany w historii przeglądarki. Obejmuje to: przesyłanie stanów (prostych obiektów, które możesz zdefiniować) do historii przeglądarki, zastępowanie najwyższego stanu w steku historii i ustawianie funkcji wywołania zwrotnego listenera w odpowiedzi na zmiany historii.

• Parametr google.script.url umożliwia pobieranie parametrów adresu URL bieżącej strony i fragmentu adresu URL, jeśli są dostępne.

Te interfejsy API dotyczące historii są dostępne tylko dla aplikacji internetowych. Nie są one obsługiwane na pasku bocznym, w oknach dialogowych ani w dodatkach. Ta funkcja nie jest też zalecana do stosowania w aplikacjach internetowych umieszczonych w witrynie Google Sites.