Jos käytät Googlen palveluita, kuten Google Docs , Google Sheets , Google Analytics , Gmail ja muita, voit yhdistää ja automatisoida kyseiset palvelut Google Apps Scriptin^{(Google Apps Script)} avulla . 

Ajattele Google Apps Scriptiä^{(Google Apps Script)} , kuten Googlen versiota Microsoftin VBA-komentosarjasta^{(Microsoft’s VBA script)} . Aivan kuten voit automatisoida toimintoja ja tehtäviä tai mukauttaa makroja Microsoft Wordissa^{(Microsoft Word)} ja Excelissä VBA^{(Excel with VBA)} :n avulla, voit automatisoida tehtäviä ja toimintoja Googlen^(Google) palveluissa. Palveluissa, kuten Sheets ja Docs , voit jopa kirjoittaa omia mukautettuja valikkoja.

Tässä artikkelissa opit käyttämään ja ottamaan käyttöön Apps Scriptin^{(Apps Script)} eri Google-palveluissasi^{(various Google services)} , kuinka selata Apps Script Editorissa^{(Apps Script Editor)} ja miten yhdistää palvelut. Et opi tiettyjä komentosarjatoimintoja^{(learn specific script functions)} , mutta Googlella^(Google) on erinomaista dokumentaatiota ja sovellusten komentosarjaopetusohjelmia, joiden avulla voit oppia kirjoittamaan Apps Scriptin^{(Apps Script)} .

Google Apps Script Editorin^{(Access Google Apps Script Editor)} käyttäminen

Voit avata Google Apps Script -koodieditorin useista Googlen^(Google) palveluista. Löydät esimerkiksi Apps Scriptin^{(Apps Script)} Google Sheetsin Laajennukset^(Extensions) - valikosta.

Muissa palveluissa voit avata Google Apps Script -editorin seuraavilla tavoilla:

• Google-dokumentit^{(Google Docs)} : Valitse Työkalut^(Tools) - valikosta Skriptieditori .^{(Script editor)}
• Google Slides : Valitse Työkalut^(Tools) - valikosta komentosarjaeditori .^{(Script editor)}
• Google Forms : Valitse kolmen pisteen valikosta Script editor .
• Google Drive : Napsauta hiiren kakkospainikkeella mitä tahansa tyhjää kohtaa, valitse Lisää^(More) ja valitse Google Apps Script .

Kun käytät jotakin näistä menetelmistä, näet Apps Script -koodieditorin avautuvan uuteen välilehteen. Tämä on ikkuna, johon kirjoitat kaikki funktiot, jotka muodostavat koko skriptisi. Oletuksena näet tyhjän funktion nimeltä myFunction(), joka on valmis, jotta voit aloittaa koodin täyttämisen.

Huomautus^(Note) : Koodin muotoilu on erittäin tärkeää virheiden välttämiseksi. Käytä kommentointia seuraavan koodin osoittamalla tavalla muistuttaaksesi itseäsi, mitä yritit tehdä koodin osissa. Tämä on hyvin samanlaista kuin kommentointi toimii HTML -koodissa verkko-ohjelmoinnin kanssa.

Kun navigoit koodieditorissa, voit palata tähän osioon valitsemalla Editor - ikkunan vasemmasta navigointiruudusta Code.gs. Näet muut käytettävissä olevat ikkunat viemällä hiiren vasemmassa reunassa olevien kuvakkeiden päälle, jolloin päänavigointiruutu avautuu.

Yleiskatsaus^(Overview) - osiossa voit löytää tilastoja skriptistäsi, kuten kuinka monta virhettä on tapahtunut, kuinka monta kertaa se on suoritettu ja paljon muuta.

Käsittelemme kaikki muut Google Apps Script -editorin osiot kussakin alla olevassa osiossa.

Google Apps Script Editorissa^{(Google Apps Script Editor)} liikkuminen

Kun muokkaat koodia editorissa, on hyvä idea valita levy ( Tallenna^(Save) ) -kuvake usein, jotta et menetä työtäsi.

Kun olet tallentanut, muut valikkovaihtoehdot syttyvät. 

Nämä sisältävät:

• Suorita^(Run) : Yritä suorittaa koko skripti alusta loppuun.
• Viankorjaus^(Debug) : Selaa skripti rivi kerrallaan.
• Toimintojen pudotusvalikko^{(Function dropdown)} : Selaa jokaista luomaasi toimintoa ja siirry niihin.
• Suoritusloki^{(Execution log)} : Katso tila- tai virheilmoitukset jokaisesta yrityksistäsi suorittaa komentosarja.

Vasemman navigointivalikon Kirjastot^(Libraries) -vaihtoehto on paikka, josta pääset kirjastoihin, jotka muut ovat kirjoittaneet (tai olet kirjoittanut ja tallentanut muualle). Tästä on hyötyä, jos sinulla on ystävä, joka on jo kirjoittanut ominaisuuden, jota haluat käyttää Google Sheetsiin^{(Google Sheets)} tai Google-dokumentteihin^{(Google Docs)} , mutta haluat lisätä sen lisäksi muita ominaisuuksia.

Sinun tarvitsee vain lisätä nämä kirjastot projektiisi Script ID . Löydät tämän projektin asetukset -osiosta, jonka osoitamme tämän artikkelin lopussa.

Google Apps Script Services -lisäosat

Palvelut^(Services) - osio on hyödyllisin. Siellä voit integroida nykyisen skriptisi muihin käyttämiisi Google - palveluihin. 

Kun valitset sen, näkyviin tulee Lisää palvelu^{(Add a service)} -ikkuna. Vieritä^(Scroll) alas palveluun, jota haluat käyttää olemassa olevan projektisi lisäosana. 

Jos esimerkiksi haluat vetää tietoja Google Analytics -tilistäsi tähän skriptiin, voit valita Google Analytics -sovellusliittymän^{(Google Analytics API)} ja sitten Lisää^(Add) .

Jos haluat saada tietoja siitä, mitä toimintoja on saatavilla kyseiselle uudelle lisäpalvelulle ja miten niitä käytetään, valitse kolme pistettä API :n oikealla puolella ja valitse Katso dokumentaatio^{(See documentation)} .

Tämä avaa Google Apps Script -dokumentaation uuteen välilehteen, joka avautuu automaattisesti kyseisen Google - palvelun osioon.

Tutustu dokumentaatioon funktion syntaksia, opetusohjelmia ja koodiesimerkkejä varten, joita voit käyttää omassa skriptissäsi.

Huomaa myös, että voit siirtyä muihin ohjeiden osiin nähdäksesi, mitä yleisiä toimintoja komentosarjassasi on sen palvelun perusteella, jota käytit, kun alun perin avasit Apps Script -koodieditorin.

Jos esimerkiksi avasit editorin Google Sheetsissä^{(Google Sheets)} , tarkista dokumentaatiovalikon Taulukot-osiossa Google ^(Sheets)Sheetsin^{(Google Sheets)} toiminnot, joita voit käyttää skriptissäsi.

Apps Script -triggereiden^{(Using Apps Script Triggers)} määrittäminen ja käyttäminen

Toinen hyödyllinen Google Apps Scriptin^{(Google Apps Script)} ominaisuus on kyky asettaa laukaisimia useiden tapahtumien tai aikataulujen perusteella.

Jos haluat määrittää uuden käynnistimen komentosarjallesi, valitse Triggerit^(Triggers) vasemmanpuoleisesta navigointivalikosta. Valitse avautuvassa uudessa Triggers -ikkunassa ^(Triggers)Lisää triggeri^{(Add Trigger)} -painike.

Add Trigger -ikkunassa on pitkä luettelo vaihtoehdoista, joiden avulla voit mukauttaa tarkalleen, miten ja milloin haluat skriptin ajavan. 

Huomautus^(Note) : Monet näistä vaihtoehdoista riippuvat palvelusta, jota kirjoitat, tai lisäämistäsi sovellusliittymistä^{(the APIs that you’ve added)} .

Määrittääksesi triggerin sinun on valittava:

• Mikä toiminto käynnistetään aluksi
• Tapahtuman lähde, kuten tietty aika, päivämäärä tai tapahtuma palvelussasi, kuten milloin Google -laskentataulukon solu muuttuu tai asiakirja avataan alun perin
• Tapahtumatyyppi, kuten milloin jotain Google - laskentataulukossasi tai -asiakirjassasi avataan tai sitä muokataan, tai päivämäärän tai kellonajan tietty asetus
• Ilmoitustiheys sen mukaan, kuinka usein haluat saada päivityksiä komentosarjojesi epäonnistumisesta

Kun valitset Tallenna^(Save) , saatat nähdä " Komentosarjan^(Script) valtuutus epäonnistui" -viestin, jos tallennat uuden triggerin ensimmäistä kertaa.

Tämä käynnistyy yleensä, jos selaimessasi on käytössä ponnahdusikkunoiden esto. Jos käytät Google Chromea^{(Google Chrome)} , valitse vain pienen ikkunan kuvake, jonka päällä on punainen X. Muuta asetukseksi Salli aina ponnahdusikkunat^{(Always allow pop-ups)} ja valitse Valmis^(Done) .

Kun valitset Tallenna^(Save) uudelleen, sinun on suoritettava prosessi, jotta kirjoittamasi skripti voidaan valtuuttaa toimimaan Google - tililläsi tai Google Workspacessa^{(Google Workspace)} .

Valitse ensin Google - tili, jonka alla haluat sallia skriptin suorittamisen.

Näet varoituksen siitä, että kirjoittamaasi mukautettua funktiota tai komentosarjaa ei ole "vahvistanut" Google . Jos olet kirjoittanut käsikirjoituksen, tällä ei ole väliä ja voit käyttää omaa Google-tiliäsi^{(Google Account)} tai Google Workspacea^{(Google Workspace)} .

Voit ohittaa tämän varoituksen valitsemalla Lisäasetukset^(Advanced) ja valitsemalla sitten Go to <project> (unsafe) -linkin alareunasta.

Valitse lopuksi lupaikkunassa Salli^(Allow) , jotta mukautetut toiminnot ja komentosarjat toimivat Google - tilisi tai Google Workspacen^{(Google Workspace)} alla .

Sinun ei tarvitse toistaa tätä prosessia uudelleen, vain ensimmäisen kerran, kun tallennat tai suoritat mukautettuja Google Apps -skriptiprojekteja. 

Google-skriptitunnuksesi käyttäminen

Viimeinen huomautus – saatat haluta toimittaa skriptisi ystäville tai kollegoille, jotta he voivat joko käyttää skriptiäsi tai lisätä sen kirjastona omaan käsikirjoitukseensa. 

Löydät komentosarjatunnuksesi^{(Script ID)} vasemman reunan navigointiruudun Asetukset^(Settings) -kuvakkeen alta .

Skriptin tunnus^{(Script ID)} löytyy Tunnukset -osiosta, Script ID -kohdan ^{(Script ID)}oikealta^(IDs) puolelta .

Kuten näet, Google Apps Script -editori on melko suoraviivainen, jos osaat navigoida kuhunkin käytettävään ominaisuuteen. Muista^(Just) vain tutkia Googlen Apps Script -dokumentaatiota hyvin, jotta voit alkaa oppia kirjoittamaan komentosarjojasi ja kaikkia käytettävissä olevia toimintoja.

Google Apps Script Editor: Everything You Need to Know to Get Started

If you use Google serviсes like Goоgle Docs, Google Sheets, Google Analytics, Gmail, and оthers, you could connect and autоmate those services using Google Apps Script. 

Think of Google Apps Script like Google’s version of Microsoft’s VBA script. Just like you can automate actions and tasks or customize macros in Microsoft Word and Excel with VBA, you can automate tasks and actions across Google services. In services like Sheets and Docs, you can even write your own custom menus.

In this article you will learn how to access and enable Apps Script in your various Google services, how to navigate the Apps Script Editor, and how to connect services. You won’t learn specific script functions, but Google has excellent documentation and apps script tutorials available to learn how to write Apps Script.

How to Access Google Apps Script Editor

You can open the Google Apps Script code editor from within a number of Google services. For example, you’ll find Apps Script in the Extensions menu inside Google Sheets.

In other services, you can open the Google Apps Script editor in the following ways:

• Google Docs: Select Script editor in the Tools menu.
• Google Slides: Select Script editor in the Tools menu.
• Google Forms: Select Script editor in the three-dot menu.
• Google Drive: Right-click any blank space, select More, and select Google Apps Script.

Using any of these methods, you’ll see the Apps Script code editor open in a new tab. This is the window where you’ll write each of the functions that make up your entire script. By default, you’ll see an empty function named myFunction() that’s ready for you to start filling in your code.

Note: Code formatting is very important in order to avoid errors. Use commenting as shown in the following code to remind yourself what you were trying to do inside sections of code. This is very similar to how commenting works in HTML code with web programming.

As you navigate the code editor, you can return to this section by selecting Code.gs in the left navigation pane in the Editor window. To see other available windows, hover over the icons in the far left pane and the main navigation pane will open.

The Overview section is where you can find statistics about your script like how many errors have occurred, how many times it’s executed, and more.

We’ll cover each of the other sections of the Google Apps Script editor in each section below.

Navigating the Google Apps Script Editor

As you edit your code in the editor, it’s a good idea to select the disk (Save) icon often so that you don’t lose your work.

Once saved, you’ll see the other menu options light up. 

These include:

• Run: Attempt to run your entire script from beginning to end.
• Debug: Step through your script one line at a time.
• Function dropdown: Browse through and navigate to each of the functions you’ve created.
• Execution log: See any status or error messages from each attempt you’ve made to run your script.

The Libraries option in the left navigation menu is where you can access libraries that other people have written (or you’ve written and saved elsewhere). This is useful if you have a friend who already wrote a feature you’d like to use in Google Sheets or Google Docs but you’d like to add additional features on top of that.

All you need to add those libraries into your project is the Script ID. You can find this in the project settings section, which we’ll show you how to find toward the end of this article.

Google Apps Script Services Add-Ons

The Services section is the most useful. It’s where you can integrate your current script with other Google services you may use. 

When you select it, you’ll see the Add a service window open. Scroll down to the service you want to use as an add-on to your existing project. 

For example, if you’d like to pull data from your Google Analytics account into this script, you can select the Google Analytics API, and select Add.

If you want to find details about what functions are available to use for that new add-on service and how to use them, select the three dots to the right of the API and select See documentation.

This will open the Google Apps Script documentation in a new tab, opened automatically to the section for that Google service.

Explore the documentation for function syntax, tutorials, and code examples that you can use in your own script.

Also, note that you can navigate to other sections of the documentation to see what general functions are available in your script based on the service you were using when you originally opened the Apps Script code editor.

For example, if you opened the editor in Google Sheets, check the Sheets section in the documentation menu for Google Sheets functions you’re able to use in your script.

Setting Up and Using Apps Script Triggers

Another useful feature in Google Apps Script is the ability to set triggers based on a number of events or schedules.

To configure a new trigger for your script, select Triggers from the far left navigation menu. In the new Triggers window that opens, select the Add Trigger button.

The Add Trigger window has a long list of options that help you customize exactly how and when you want your script to run. 

Note: Many of these options depend on the service you’re writing your script for or the APIs that you’ve added.

To set up your trigger, you’ll need to choose:

• Which function to initially launch
• The event source such as a specific time, date, or an event in your service like when a Google spreadsheet cell changes or a document is initially opened
• The event type such as when something in your Google spreadsheet or document is opened or edited, or the specific setting for date or time
• Notification frequency for how often you want to get updates about when your scripts have failed

Once you select Save, you may see a “Script authorization failed” message if it’s the first time you’ve saved a new trigger.

This is usually triggered if you have a pop-up blocker enabled in your browser. If you’re using Google Chrome, just select the small window icon with a red “X” over it. Change the setting to Always allow pop-ups and select Done.

When you select Save again, you’ll need to step through the process to authorize the script you’ve written to run under your Google account or Google Workspace.

First, select the Google account that you want to allow your script to run under.

You’ll see a warning that the custom function or script you wrote isn’t “verified” by Google. If you’re the person who wrote the script, then this doesn’t matter and it’s safe to run under your own Google Account or Google Workspace.

To bypass this warning, just select Advanced and then select the Go to <project> (unsafe) link at the bottom.

Finally, in the permissions window, select Allow to allow your custom functions and script to run under your Google account or Google Workspace.

You won’t have to repeat this process again, only the first time you save or run your custom Google Apps script projects. 

Accessing Your Google Script ID

One final note – you may want to provide your script to friends or colleagues so they can either use your script or add it as a library to their own script. 

You can find your Script ID under the Settings icon in the far left navigation pane.

The Script ID can be found under the IDs section, to the right of Script ID.

As you can see, the Google Apps Script editor is fairly straightforward if you know how to navigate to each feature you want to use. Just make sure to study Google’s Apps Script documentation well so that you can start learning how to write your scripts and all functions that are available to use.

Related posts

• Kuinka Googlen kokeelliset sovellukset voivat auttaa sinua torjumaan digitaaliriippuvuutta

• 5 parasta sinisen valon suodatinsovellusta Windowsille, Macille ja Linuxille

• 5 kannettavaa sovellusta, jotka haluat ehdottomasti USB-muistitikullasi

• Google Chromen automaattinen täyttö: täydellinen opas

• 4 parasta porttien edelleenlähetysohjelmistosovellusta ja niiden käyttö

• Käytä vanhaa verkkokameraa kiinteistösi seuraamiseen ilmaiseksi

• 6 parasta sovellusta suorittimen lämpötilan tarkistamiseen Windows 11/10:ssä

• Mikä on chatbot ja kuinka sitä käytetään sivustollasi

• 5 parasta ohjelmistoa kahden näytön hallintaan

• Siirrä, poista tai kopioi tiedostoja automaattisesti Windowsissa

• Google Draw: täydellinen opas aloittelijoille

• Kuinka verkkosivustot toimivat: Opi mitä konepellin alla on

• Parhaat suorittimen, näytönohjaimen ja RAM-viritysapuohjelmat

• Opi koodaamaan kuin ammattilainen näiden 5 sivuston ja sovelluksen avulla

• Google Translate vs. Bing Translate – kumpi on paras?

• 4 erinomaista työkalua Windows Installer -pakettien luomiseen

• 7 parasta bloatware-poistotyökalua Windowsille

• Avast Online Security -laajennus: kannattaako sitä käyttää?

• 11 parasta Microsoft Teams -sovellusta vuonna 2022

• Parhaat WiFi-analysaattorisovellukset Windowsille, iOS:lle, macOS:lle ja Androidille