Google Apps Script Editor: alles wat u moet weten om aan de slag te gaan

Als u Google-services zoals Google Docs , Google Spreadsheets(Google Sheets) , Google Analytics , Gmail en andere gebruikt, kunt u deze services koppelen en automatiseren met Google Apps Script

Denk aan Google Apps Script als de Google-versie van het VBA-script van Microsoft(Microsoft’s VBA script) . Net zoals u acties en taken kunt automatiseren of macro's kunt aanpassen in Microsoft Word en Excel met VBA(Excel with VBA) , kunt u taken en acties automatiseren in Google- services. In services zoals Spreadsheets en Documenten(Docs) kunt u zelfs uw eigen aangepaste menu's schrijven.

In dit artikel leert u hoe u Apps Script opent(Apps Script) en inschakelt in uw verschillende Google-services , hoe u door de (various Google services)Apps Script Editor navigeert en hoe u services verbindt. U zult geen specifieke scriptfuncties leren(learn specific script functions) , maar Google heeft uitstekende documentatie en handleidingen voor apps-scripts beschikbaar om te leren hoe u Apps Script schrijft .

Toegang krijgen tot Google Apps Script Editor(Access Google Apps Script Editor)

U kunt de code-editor van Google Apps Script openen vanuit een aantal Google - services. U vindt Apps Script bijvoorbeeld in het menu Extensies(Extensions) in Google Spreadsheets.

In andere services kunt u de Google Apps Script- editor op de volgende manieren openen:

  • Google Docs : selecteer Scripteditor in het menu Extra .(Tools)
  • Google Presentaties(Google Slides) : selecteer Scripteditor in het menu Extra .(Tools)
  • Google Formulieren(Google Forms) : selecteer Scripteditor in het menu met drie stippen.
  • Google Drive : klik met de rechtermuisknop op een lege ruimte, selecteer Meer(More) en selecteer Google Apps Script .

Als u een van deze methoden gebruikt, wordt de Apps Script -code-editor geopend in een nieuw tabblad. Dit is het venster waarin u elk van de functies schrijft waaruit uw hele script bestaat. Standaard ziet u een lege functie met de naam myFunction() die klaar staat om uw code in te vullen.

Opmerking(Note) : Code-opmaak is erg belangrijk om fouten te voorkomen. Gebruik commentaar zoals weergegeven in de volgende code om jezelf eraan te herinneren wat je probeerde te doen in delen van de code. Dit lijkt erg op hoe commentaar werkt in HTML -code met webprogrammering.

Terwijl u door de code-editor navigeert, kunt u terugkeren naar deze sectie door Code.gs te selecteren in het linkernavigatievenster in het Editor - venster. Om andere beschikbare vensters te zien, beweegt u de muisaanwijzer over de pictogrammen in het uiterst linkse deelvenster en het hoofdnavigatievenster wordt geopend.

In het gedeelte Overzicht(Overview) kunt u statistieken over uw script vinden, zoals hoeveel fouten er zijn opgetreden, hoe vaak het is uitgevoerd en meer.

We behandelen elk van de andere secties van de Google Apps Script- editor in elke sectie hieronder.

Navigeren door de Google Apps Script Editor

Als u uw code in de editor bewerkt, is het een goed idee om het schijfpictogram ( Opslaan(Save) ) vaak te selecteren, zodat u uw werk niet kwijtraakt.

Eenmaal opgeslagen, ziet u de andere menu-opties oplichten. 

Waaronder:

  • Uitvoeren(Run) : probeer uw hele script van begin tot eind uit te voeren.
  • Debuggen(Debug) : doorloop uw script regel voor regel.
  • Vervolgkeuzelijst Functie(Function dropdown) : blader door en navigeer naar elk van de functies die u hebt gemaakt.
  • Uitvoeringslogboek(Execution log) : bekijk eventuele status- of foutmeldingen van elke poging die u hebt gedaan om uw script uit te voeren.

Met de optie Bibliotheken(Libraries) in het linkernavigatiemenu hebt u toegang tot bibliotheken die andere mensen hebben geschreven (of die u ergens anders hebt geschreven en opgeslagen). Dit is handig als je een vriend hebt die al een functie heeft geschreven die je wilt gebruiken in Google Spreadsheets(Google Sheets) of Google Documenten(Google Docs) , maar je wilt daar nog extra functies aan toevoegen.

Het enige dat u nodig hebt om die bibliotheken aan uw project toe te voegen, is de Script-ID . Je kunt dit vinden in het gedeelte met projectinstellingen, waar we je aan het einde van dit artikel laten zien hoe je dit kunt vinden.

Add-ons voor Google Apps Script Services

Het gedeelte Services is het handigst. Hier kunt u uw huidige script integreren met andere Google - services die u mogelijk gebruikt. 

Wanneer u het selecteert, ziet u het venster Een service toevoegen geopend. (Add a service)Scrol(Scroll) omlaag naar de service die u als add-on voor uw bestaande project wilt gebruiken. 

Als u bijvoorbeeld gegevens uit uw Google Analytics - account in dit script wilt opnemen, kunt u de Google Analytics-API selecteren en Toevoegen(Add) selecteren .

Als u details wilt vinden over welke functies beschikbaar zijn voor die nieuwe add-onservice en hoe u deze kunt gebruiken, selecteert u de drie stippen rechts van de API en selecteert u Zie documentatie(See documentation) .

Hierdoor wordt de Google Apps Script - documentatie geopend op een nieuw tabblad, dat automatisch wordt geopend in de sectie voor die Google -service.

Verken de documentatie voor functiesyntaxis, zelfstudies en codevoorbeelden die u in uw eigen script kunt gebruiken.

Houd er ook rekening mee dat u naar andere secties van de documentatie kunt navigeren om te zien welke algemene functies beschikbaar zijn in uw script op basis van de service die u gebruikte toen u de Apps Script -code-editor opende.

Als u bijvoorbeeld de editor in Google Spreadsheets(Google Sheets) heeft geopend , controleert u het gedeelte Spreadsheets(Sheets) in het documentatiemenu voor Google Spreadsheets-(Google Sheets) functies die u in uw script kunt gebruiken.

Apps Script-triggers(Using Apps Script Triggers) instellen en gebruiken

Een andere handige functie in Google Apps Script is de mogelijkheid om triggers in te stellen op basis van een aantal gebeurtenissen of schema's.

Om een ​​nieuwe trigger voor uw script te configureren, selecteert u Triggers in het navigatiemenu uiterst links. Selecteer in het nieuwe Triggers- venster dat wordt geopend de knop Trigger toevoegen(Add Trigger) .

Het venster Trigger toevoegen(Add Trigger) heeft een lange lijst met opties waarmee u precies kunt aanpassen hoe en wanneer u wilt dat uw script wordt uitgevoerd. 

Opmerking(Note) : Veel van deze opties zijn afhankelijk van de service waarvoor u uw script schrijft of de API's die u hebt toegevoegd(the APIs that you’ve added) .

Om je trigger in te stellen, moet je kiezen:

  • Welke functie om in eerste instantie te starten?
  • De gebeurtenisbron, zoals een specifieke tijd, datum of een gebeurtenis in uw service, zoals wanneer een Google -spreadsheetcel verandert of een document voor het eerst wordt geopend
  • Het type gebeurtenis, zoals wanneer iets in uw Google - spreadsheet of document wordt geopend of bewerkt, of de specifieke instelling voor datum of tijd
  • Meldingsfrequentie voor hoe vaak u updates wilt ontvangen over wanneer uw scripts zijn mislukt

Nadat u Opslaan(Save) heeft geselecteerd , ziet u mogelijk het bericht ' Scriptautorisatie(Script) mislukt' als dit de eerste keer is dat u een nieuwe trigger opslaat.

Dit wordt meestal geactiveerd als u een pop-upblokkering in uw browser hebt ingeschakeld. Als u Google Chrome gebruikt, selecteert u gewoon het kleine vensterpictogram met een rode "X" erover. Wijzig de instelling in Pop-ups altijd toestaan(Always allow pop-ups) ​​en selecteer Gereed(Done) .

Wanneer je opnieuw Opslaan(Save) selecteert , moet je het proces doorlopen om het script dat je hebt geschreven te autoriseren om te worden uitgevoerd onder je Google - account of Google Workspace .

Selecteer eerst het Google- account waaronder u uw script wilt laten uitvoeren.

U ziet een waarschuwing dat de aangepaste functie of het script dat u heeft geschreven, niet is 'geverifieerd' door Google . Als u de persoon bent die het script heeft geschreven, maakt dit niet uit en kunt u het veilig uitvoeren onder uw eigen Google-account of Google Workspace .

Om deze waarschuwing te omzeilen, selecteert u Geavanceerd(Advanced) en selecteert u vervolgens de link Go to <project> (unsafe) onderaan.

Selecteer ten slotte in het machtigingenvenster Toestaan(Allow) ​​om uw aangepaste functies en script onder uw Google - account of Google Workspace te laten draaien .

U hoeft dit proces niet opnieuw te herhalen, alleen de eerste keer dat u uw aangepaste Google Apps -scriptprojecten opslaat of uitvoert. 

Toegang tot uw Google Script-ID

Een laatste opmerking: misschien wil je je script aan vrienden of collega's geven, zodat ze je script kunnen gebruiken of het als bibliotheek aan hun eigen script kunnen toevoegen. 

U kunt uw Script-ID vinden onder het pictogram Instellingen(Settings) in het navigatievenster uiterst links.

De Script-ID is te vinden onder de sectie ID's , rechts van Script-ID .

Zoals u kunt zien, is de Google Apps Script -editor redelijk eenvoudig als u weet hoe u naar elke functie moet navigeren die u wilt gebruiken. Zorg(Just) ervoor dat u de Google Apps Script - documentatie goed bestudeert, zodat u kunt leren hoe u uw scripts en alle beschikbare functies kunt schrijven.



About the author

Ik ben een softwareontwikkelaar met meer dan 10 jaar ervaring. Ik ben gespecialiseerd in Mac-programmering en heb duizenden regels code geschreven voor verschillende Mac-programma's, waaronder maar niet beperkt tot: TextEdit, GarageBand, iMovie en Inkscape. Ook heb ik ervaring met Linux en Windows ontwikkeling. Dankzij mijn vaardigheden als ontwikkelaar kan ik hoogwaardige, uitgebreide tutorials schrijven voor verschillende softwareontwikkelingsplatforms - van macOS tot Linux - waardoor mijn tutorials de perfecte keuze zijn voor diegenen die meer willen weten over de tools die ze gebruiken.



Related posts