google-apps-script Samouczek
Rozpoczęcie pracy z Google-apps-script

Uwagi

Instalacja lub konfiguracja

Skrypt Google Apps nie wymaga konfiguracji ani instalacji. Jedynym wymaganiem jest konto Google. Konto Gmail działa tak samo jak konto Google Apps for Work / Education / Government. Możesz utworzyć nowe konto Google, wchodząc na accounts.google.com

Rozpocznij swój pierwszy skrypt, przechodząc do script.google.com . Możesz także uzyskać dostęp do Google Apps Script za pomocą tools -> Script editor... wielu Google Apps, tj. Dokumentów, Arkuszy, Formularzy itp . Skrypt Google Apps można również dodać bezpośrednio do Dysku Google za pomocą funkcji Connect more apps..

Oficjalna dokumentacja znajduje się na stronie developers.google.com/apps-script/ .

Aby skrypty aplikacji mogły działać, muszą zawierać plik code.gs. Plik code.gs musi zawierać funkcję o nazwie doGet (skrypty autonomiczne) lub funkcję onOpen (skrypty addon). Szybki start w dokumentacji zawiera przykłady.

Jeśli interfejs API jest włączony w skrypcie aplikacji, musi być również włączony w konsoli programisty. Jednak konsola programisty zawiera interfejsy API, które można włączyć, ale nie pojawiają się w interfejsie skryptu aplikacji. Na przykład pakiet Marketplace SDK musi być włączony w konsoli programisty, zanim aplikacja będzie mogła zostać opublikowana w sklepie Google Play lub w całym wdrożeniu domeny G Suite.

W przypadku aplikacji Google do edukacji / pracy / administracji w konsoli administracyjnej domeny znajdują się ustawienia, które można dostosować, aby zezwalały na uruchamianie skryptów aplikacji lub zezwalały na nie.

Rodzaje skryptów

Skrypty aplikacji Google są trzech typów.

• Samodzielny
• Związany z Google Apps
• internetowe aplikacje

Samodzielny skrypt

Autonomiczne skrypty nie są powiązane z żadnymi aplikacjami Google, tj. Dokumentami, Arkuszami ani Formularzami itp. Autonomiczny skrypt można utworzyć, odwiedzając skrypt.google.com lub łącząc skrypt aplikacji Google z dyskiem Google. Autonomiczny skrypt może być używany do niezależnego programowania aplikacji Google, może być używany jako aplikacja internetowa lub może być skonfigurowany do automatycznego uruchamiania z instalowalnego wyzwalacza. Zobacz dokumentację samodzielnego skryptu.

Związany z Google Apps

Skrypt powiązany z Google Apps, znany również jako skrypt powiązany z kontenerem; w przeciwieństwie do samodzielnych skryptów, są powiązane z aplikacjami Google, tj. Dokumentami Google lub Arkuszami Google itp. Skrypt związany z kontenerem można utworzyć, wybierając tools> Script editor z aplikacji Google. Niektóre funkcje, takie jak okna dialogowe, monity, menu i pasek boczny, są dostarczane tylko przez skrypty powiązane z kontenerem. Ponadto do tworzenia dodatków Google służy skrypt powiązany z kontenerem. Zobacz dokumentację skryptów związanych z kontenerem.

internetowe aplikacje

Google App Script może być używany jako aplikacja internetowa, ponieważ można uzyskać do niego dostęp za pomocą przeglądarki. Aplikacja internetowa może zapewniać interfejs użytkownika w przeglądarce i może korzystać z aplikacji Google, tj. Dokumentów, arkuszy itp. Zarówno samodzielne skrypty, jak i skrypty powiązane z Google Apps można przekształcić w aplikacje internetowe. Aby dowolny skrypt działał jako aplikacja internetowa, skrypt musi spełniać dwa wymagania:

• obejmują funkcję doGet() lub doPost() .
• Funkcja zwraca obiekt HtmlOutput usługi HTML lub obiekt TextOutput usługi treści.

Funkcje Inshort, doGet() i doPost() działają odpowiednio jak procedury obsługi pobierania i wysyłania żądań HTTP.

Aby uzyskać więcej informacji na temat aplikacji internetowych, zobacz oficjalną dokumentację .

Uruchamianie / debugowanie skryptu

Spróbuj uruchomić kod z paska narzędzi, jak pokazano poniżej:

Jeśli w kodzie masz więcej niż jedną funkcję, przed uruchomieniem powinieneś wspomnieć o funkcji, którą chcesz uruchomić. Na przykład :

Alternatywnie możesz nacisnąć ctrl + r na klawiaturze, aby uruchomić kod. Najpierw zapisze kod, jeśli nie zostanie zapisany, a następnie uruchom go. Ale aby to zadziałało, musisz wybrać funkcję, jak pokazano na powyższym obrazku.

Ponadto, jeśli skrypt jest wywoływany przez niektóre działania zewnętrzne, nadal będziesz mógł zobaczyć dzienniki, klikając view-> logs, jeśli logujesz coś po wykonaniu kodu.

Witaj świecie

Powitamy jako okno wiadomości.

function helloWorld() 
{
  Browser.msgBox("Hello World");
}

Aby wykonać skrypt, kliknij ▶ lub wybierz element menu Uruchom -> helloWorld

Głębsze spojrzenie na Google Apps Script

Google Apps Script to oparta na JavaScript platforma jako usługa służąca głównie do automatyzacji i rozszerzania Google Apps. Apps Script działa wyłącznie w infrastrukturze Google, nie wymagając obsługi administracyjnej ani konfiguracji serwera. Internetowe IDE służy jako interfejs do całej platformy łączącej wszystkie usługi dostępne dla Apps Script. Uwierzytelnianie użytkownika jest wprowadzane na platformę za pośrednictwem OAuth2 i nie wymaga kodu ani konfiguracji ze strony autora skryptu.

Apps Script działa po stronie serwera, ale może mieć interfejsy użytkownika zbudowane za pomocą HTML, CSS, JavaScript lub dowolnej innej technologii obsługiwanej przez przeglądarkę. W przeciwieństwie do Nodejs, który jest sterowany zdarzeniami, skrypty aplikacji działają w modelu wątkowym. Wszystkie wywołania skryptu generują unikalną instancję tego skryptu, która działa w oderwaniu od wszystkich innych instancji. Gdy instancja skryptu zakończy wykonywanie, zostaje zniszczona.

Funkcje w Apps Script są blokowane, więc wzorce programowania zwrotnego i asynchronicznego nie są potrzebne. Blokowanie służy do zapobiegania jednoczesnemu wykonywaniu krytycznych sekcji kodu, takich jak IO pliku, przez różne instancje.

W praktyce pisanie skryptów aplikacji jest proste. Poniżej znajduje się prosty skrypt, który tworzy nowy arkusz kalkulacyjny z szablonu arkusza kalkulacyjnego.

// Create a new spreadsheet from a template
function createSpreadsheet(){
   var templateFileId = '1Azcz9GwCeHjGl9TXf4aUh6g20Eqmgd1UMSdNVjzIZPk';
   var sheetName = 'Account Log for:' + new Date();
   SpreadsheetApp.openById(templateFileId).copy(sheetName);   
}