Google Apps Script Editor: Všetko, čo potrebujete vedieť, aby ste mohli začať

Ak používate služby Google, ako sú Dokumenty(Google Docs) Google , Tabuľky(Google Sheets) Google , Google Analytics , Gmail a ďalšie, môžete tieto služby prepojiť a automatizovať pomocou skriptu Google Apps Script(Google Apps Script)

Predstavte si Google Apps Script ako verziu skriptu VBA od spoločnosti Microsoft(Microsoft’s VBA script) od spoločnosti Google . Rovnako ako môžete automatizovať akcie a úlohy alebo prispôsobiť makrá v programoch Microsoft Word(Microsoft Word) a Excel pomocou jazyka VBA(Excel with VBA) , môžete automatizovať úlohy a akcie v službách Google . V službách, ako sú Tabuľky a Dokumenty(Docs) , si dokonca môžete napísať svoje vlastné ponuky.

V tomto článku sa dozviete, ako získať a povoliť Apps Script v rôznych službách Google(various Google services) , ako sa pohybovať v editore Apps Script(Apps Script Editor) a ako pripojiť služby. Nedozviete sa konkrétne funkcie skriptu(learn specific script functions) , ale spoločnosť Google(Google) má k dispozícii vynikajúcu dokumentáciu a návody na skriptovanie aplikácií, kde sa dozviete, ako písať skript Apps(Apps Script) .

Ako získať prístup k editoru skriptov Google Apps(Access Google Apps Script Editor)

Editor kódu Google Apps Script môžete otvoriť z viacerých služieb Google . Apps Script napríklad nájdete v ponuke Rozšírenia(Extensions) v Tabuľkách Google.

V iných službách môžete otvoriť editor Google Apps Script nasledujúcimi spôsobmi:

  • Dokumenty Google(Google Docs) : Vyberte položku Editor skriptov(Script editor) v ponuke Nástroje(Tools) .
  • Prezentácie Google(Google Slides) : Vyberte položku Editor skriptov(Script editor) v ponuke Nástroje(Tools) .
  • Formuláre Google(Google Forms) : V trojbodkovej ponuke vyberte položku Editor skriptov(Script editor) .
  • Disk Google(Google Drive) : Kliknite pravým tlačidlom myši na ľubovoľné prázdne miesto, vyberte položku Viac(More) a vyberte položku Google Apps Script .

Pomocou ktorejkoľvek z týchto metód uvidíte, že editor kódu Apps Script sa otvorí na novej karte. Toto je okno, kde budete písať každú z funkcií, ktoré tvoria celý váš skript. V predvolenom nastavení uvidíte prázdnu funkciu s názvom myFunction(), ktorá je pripravená na to, aby ste mohli začať vypĺňať kód.

Poznámka(Note) : Formátovanie kódu je veľmi dôležité, aby sa predišlo chybám. Použite komentáre, ako je znázornené v nasledujúcom kóde, aby ste si pripomenuli, čo ste sa pokúšali robiť v častiach kódu. Je to veľmi podobné tomu, ako funguje komentovanie v kóde HTML(HTML) s webovým programovaním.

Pri navigácii v editore kódu sa môžete vrátiť do tejto sekcie výberom Code.gs na ľavej navigačnej table v okne Editor . Ak chcete zobraziť ďalšie dostupné okná, umiestnite kurzor myši na ikony v úplne ľavom paneli a otvorí sa hlavný navigačný panel.

Sekcia Prehľad(Overview) je miesto, kde môžete nájsť štatistiky o svojom skripte, napríklad koľko chýb sa vyskytlo, koľkokrát bol spustený a ďalšie.

V každej časti nižšie sa budeme zaoberať každou ďalšou sekciou editora Google Apps Script .

Navigácia v editore skriptov Google Apps(Google Apps Script Editor)

Pri úprave kódu v editore je dobré často vyberať ikonu disku ( Uložiť(Save) ), aby ste o svoju prácu neprišli.

Po uložení sa rozsvietia ďalšie možnosti ponuky. 

Tie obsahujú:

  • Spustiť(Run) : Pokúste sa spustiť celý skript od začiatku do konca.
  • Ladenie(Debug) : Prechádzajte skriptom jeden riadok po druhom.
  • Rozbaľovacia ponuka funkcií(Function dropdown) : Prechádzajte a prechádzajte na každú z funkcií, ktoré ste vytvorili.
  • Protokol vykonania(Execution log) : Pozrite si všetky stavové alebo chybové správy z každého pokusu o spustenie skriptu.

Voľba Knižnice(Libraries) v ľavom navigačnom menu je miesto, kde máte prístup ku knižniciam, ktoré napísali iní ľudia (alebo ste ich napísali a uložili inde). Je to užitočné, ak máte priateľa, ktorý už napísal funkciu, ktorú by ste chceli použiť v Tabuľkách(Google Sheets) Google alebo Dokumentoch Google(Google Docs) , ale chceli by ste k tomu pridať ďalšie funkcie.

Všetko, čo potrebujete na pridanie týchto knižníc do vášho projektu, je ID skriptu(Script ID) . Môžete to nájsť v sekcii nastavení projektu, ktorú vám ukážeme, ako ju nájsť na konci tohto článku.

Doplnky služby Google Apps Script Services

Najužitočnejšia je sekcia Služby . (Services)Tu môžete integrovať svoj aktuálny skript s inými službami Google , ktoré môžete používať. 

Keď ju vyberiete, zobrazí sa okno Pridať službu . (Add a service)Prejdite(Scroll) nadol na službu, ktorú chcete použiť ako doplnok k vášmu existujúcemu projektu. 

Ak by ste napríklad chceli stiahnuť údaje z účtu Google Analytics do tohto skriptu, môžete vybrať rozhranie Google Analytics API(Google Analytics API) a vybrať možnosť Pridať(Add) .

Ak chcete nájsť podrobnosti o tom, aké funkcie sú k dispozícii na použitie pre túto novú doplnkovú službu a ako ich používať, vyberte tri bodky napravo od rozhrania API(API) a vyberte Zobraziť dokumentáciu(See documentation) .

Tým sa otvorí dokumentácia Google Apps Script na novej karte, ktorá sa automaticky otvorí v sekcii pre danú službu Google(Google) .

Preskúmajte dokumentáciu pre syntax funkcií, návody a príklady kódu, ktoré môžete použiť vo svojom vlastnom skripte.

Upozorňujeme tiež, že môžete prejsť do iných sekcií dokumentácie, aby ste videli, aké všeobecné funkcie sú dostupné vo vašom skripte na základe služby, ktorú ste používali, keď ste pôvodne otvorili editor kódu Apps Script .

Ak ste napríklad otvorili editor v Tabuľkách Google(Google Sheets) , skontrolujte v ponuke dokumentácie sekciu Tabuľky , kde nájdete funkcie Tabuľky (Sheets)Google(Google Sheets) , ktoré môžete použiť vo svojom skripte.

Nastavenie a používanie spúšťačov Apps Script(Using Apps Script Triggers)

Ďalšou užitočnou funkciou v Google Apps Script je možnosť nastaviť spúšťače na základe množstva udalostí alebo plánov.

Ak chcete nakonfigurovať nový spúšťač pre svoj skript, vyberte položku Spúšťače(Triggers) z navigačnej ponuky úplne vľavo. V novom okne Spúšťače(Triggers) , ktoré sa otvorí, vyberte tlačidlo Pridať spúšťač(Add Trigger) .

Okno Pridať spúšťač(Add Trigger) obsahuje dlhý zoznam možností, ktoré vám pomôžu presne prispôsobiť, ako a kedy chcete, aby sa skript spúšťal. 

Poznámka(Note) : Mnohé z týchto možností závisia od služby, pre ktorú píšete skript, alebo od rozhraní API, ktoré ste pridali(the APIs that you’ve added) .

Ak chcete nastaviť spúšťač, budete musieť vybrať:

  • Ktorú funkciu spustiť na začiatku
  • zdroj udalosti, ako je konkrétny čas, dátum alebo udalosť vo vašej službe, napríklad keď sa zmení bunka tabuľky Google alebo sa prvýkrát otvorí dokument
  • Typ udalosti, napríklad keď sa niečo vo vašej tabuľke alebo dokumente Google otvorí alebo upraví, alebo konkrétne nastavenie dátumu alebo času
  • Frekvencia upozornení, ako často chcete dostávať aktualizácie o zlyhaní skriptov

Po výbere možnosti Uložiť(Save) sa môže zobraziť správa „ Autorizácia skriptu(Script) zlyhala“, ak je to prvýkrát, čo ukladáte nový spúšťač.

Zvyčajne sa to spustí, ak máte vo svojom prehliadači povolený blokovač automaticky otváraných okien. Ak používate prehliadač Google Chrome(Google Chrome) , stačí vybrať ikonu malého okna s červeným znakom X. Zmeňte nastavenie na Vždy povoliť kontextové okná(Always allow pop-ups) a vyberte Hotovo(Done) .

Keď znova vyberiete možnosť Uložiť(Save) , budete musieť prejsť celým procesom, aby ste autorizovali spustenie skriptu, ktorý ste napísali pod vaším účtom Google(Google) alebo Google Workspace .

Najprv vyberte účet Google , pod ktorým chcete povoliť spustenie skriptu.

Zobrazí sa upozornenie, že vami napísaná vlastná funkcia alebo skript nie je „overený“ spoločnosťou Google . Ak ste ten, kto napísal skript, potom na tom nezáleží a môžete ho bezpečne spustiť pod vlastným účtom Google(Google Account) alebo Google Workspace .

Ak chcete toto upozornenie obísť, stačí vybrať položku Rozšírené(Advanced) a potom v spodnej časti vybrať odkaz Go to <project> (unsafe)

Nakoniec v okne povolení vyberte možnosť Povoliť(Allow) , čím povolíte spustenie vlastných funkcií a skriptu pod vaším účtom Google(Google) alebo Google Workspace .

Tento proces už nebudete musieť opakovať, iba pri prvom uložení alebo spustení vlastných projektov skriptov  Google Apps .

Prístup k vášmu Google Script ID

Jedna poznámka na záver – možno budete chcieť poskytnúť svoj skript priateľom alebo kolegom, aby mohli použiť váš skript alebo ho pridať ako knižnicu do vlastného skriptu. 

Svoje ID skriptu(Script ID) nájdete pod ikonou Nastavenia(Settings) na navigačnej table úplne vľavo.

ID skriptu(Script ID) nájdete v sekcii ID(IDs) napravo od ID skriptu(Script ID) .

Ako vidíte, editor Google Apps Script je pomerne jednoduchý, ak viete, ako prejsť na každú funkciu, ktorú chcete použiť. Nezabudnite(Just) si dobre preštudovať dokumentáciu k skriptu Apps Script(Apps Script) od spoločnosti Google , aby ste sa mohli začať učiť písať svoje skripty a všetky funkcie, ktoré sú k dispozícii na použitie.



About the author

Som softvérový vývojár s viac ako 10-ročnými skúsenosťami. Špecializujem sa na programovanie pre Mac a napísal som niekoľko tisíc riadkov kódu pre rôzne aplikácie Mac, vrátane, ale nie výlučne: TextEdit, GarageBand, iMovie a Inkscape. Mám skúsenosti aj s vývojom pre Linux a Windows. Moje zručnosti vývojára mi umožňujú písať vysokokvalitné a komplexné návody pre rôzne platformy vývoja softvéru – od macOS po Linux – vďaka čomu sú moje návody ideálnou voľbou pre tých, ktorí sa chcú dozvedieť viac o nástrojoch, ktoré používajú.



Related posts