Jeśli korzystasz z usług Google, takich jak Dokumenty^{(Google Docs)} Google , Arkusze^{(Google Sheets)} Google , Google Analytics , Gmail i inne, możesz połączyć te usługi i zautomatyzować je za pomocą Google Apps Script . 

Pomyśl o skrypcie Aplikacji^{(Google Apps Script)} Google jak o wersji Google skryptu VBA firmy Microsoft^{(Microsoft’s VBA script)} . Tak jak możesz automatyzować czynności i zadania lub dostosowywać makra w programach Microsoft Word i Excel za pomocą VBA^{(Excel with VBA)} , możesz zautomatyzować zadania i czynności w usługach Google . W usługach takich jak Arkusze i Dokumenty^(Docs) możesz nawet tworzyć własne niestandardowe menu.

Z tego artykułu dowiesz się, jak uzyskać dostęp do Apps Script i włączyć go w różnych usługach Google^{(various Google services)} , jak poruszać się po edytorze Apps Script^{(Apps Script Editor)} oraz jak łączyć usługi. Nie nauczysz się konkretnych funkcji skryptów^{(learn specific script functions)} , ale Google oferuje doskonałą dokumentację i samouczki dotyczące skryptów aplikacji, z których można dowiedzieć się, jak pisać Apps Script .

Jak uzyskać dostęp do Edytora skryptów Aplikacji Google^{(Access Google Apps Script Editor)}

Edytor kodu Google Apps Script można otworzyć w wielu usługach Google . Na przykład skrypt Apps Script^{(Apps Script)} znajdziesz w menu Rozszerzenia^(Extensions) w Arkuszach Google.

W innych usługach edytor skryptów Google Apps^{(Google Apps Script)} można otworzyć w następujący sposób:

• Dokumenty Google^{(Google Docs)} : wybierz Edytor skryptów^{(Script editor)} w menu Narzędzia^(Tools) .
• Prezentacje Google^{(Google Slides)} : wybierz Edytor skryptów^{(Script editor)} w menu Narzędzia^(Tools) .
• Formularze Google^{(Google Forms)} : wybierz Edytor skryptów^{(Script editor)} w menu z trzema kropkami.
• Dysk Google^{(Google Drive)} : kliknij prawym przyciskiem myszy dowolne puste miejsce, wybierz Więcej^(More) , a następnie wybierz Skrypt Google Apps^{(Google Apps Script)} .

Korzystając z dowolnej z tych metod, edytor kodu Apps Script zostanie otwarty w nowej karcie. To jest okno, w którym napiszesz każdą z funkcji, które składają się na cały twój skrypt. Domyślnie zobaczysz pustą funkcję o nazwie myFunction(), która jest gotowa do rozpoczęcia wypełniania kodu.

Uwaga^(Note) : formatowanie kodu jest bardzo ważne, aby uniknąć błędów. Użyj komentowania, jak pokazano w poniższym kodzie, aby przypomnieć sobie, co próbowałeś zrobić w sekcjach kodu. Jest to bardzo podobne do tego, jak komentowanie działa w kodzie HTML z programowaniem internetowym.

Podczas nawigowania po edytorze kodu możesz wrócić do tej sekcji, wybierając Code.gs w lewym okienku nawigacyjnym w oknie edytora^(Editor) . Aby zobaczyć inne dostępne okna, najedź kursorem na ikony w lewym okienku, a otworzy się główne okienko nawigacji.

Sekcja Przegląd^(Overview) to miejsce, w którym można znaleźć statystyki dotyczące skryptu, takie jak liczba błędów, ile razy został wykonany i nie tylko.

W każdej z poniższych sekcji omówimy każdą z pozostałych sekcji edytora skryptów Google Apps .^{(Google Apps Script)}

Poruszanie się po edytorze skryptów Google Apps^{(Google Apps Script Editor)}

Kiedy edytujesz swój kod w edytorze, dobrze jest często wybierać ikonę dysku ( Zapisz^(Save) ), aby nie stracić pracy.

Po zapisaniu zostaną wyświetlone inne opcje menu. 

Obejmują one:

• Uruchom^(Run) : spróbuj uruchomić cały skrypt od początku do końca.
• Debugowanie^(Debug) : Przechodź przez skrypt jeden wiersz na raz.
• Lista funkcji^{(Function dropdown)} : przeglądaj i przejdź do każdej utworzonej funkcji.
• Dziennik wykonania^{(Execution log)} : wyświetla wszystkie komunikaty o stanie lub błędach z każdej podjętej przez Ciebie próby uruchomienia skryptu.

Opcja Biblioteki^(Libraries) w lewym menu nawigacyjnym umożliwia dostęp do bibliotek napisanych przez inne osoby (lub napisanych i zapisanych w innym miejscu). Jest to przydatne, jeśli masz znajomego, który już napisał funkcję, której chcesz użyć w Arkuszach^{(Google Sheets)} Google lub Dokumentach Google^{(Google Docs)} , ale chcesz dodać do tego dodatkowe funkcje.

Wszystko, czego potrzebujesz, aby dodać te biblioteki do swojego projektu, to identyfikator skryptu^{(Script ID)} . Możesz to znaleźć w sekcji ustawień projektu, którą pokażemy pod koniec tego artykułu.

Dodatki do usług skryptów Google Apps

Sekcja Usługi^(Services) jest najbardziej przydatna. Tutaj możesz zintegrować swój obecny skrypt z innymi usługami Google , z których możesz korzystać. 

Gdy ją wybierzesz, zobaczysz otwarte okno Dodaj usługę . ^{(Add a service)}Przewiń^(Scroll) w dół do usługi, której chcesz użyć jako dodatku do istniejącego projektu. 

Jeśli na przykład chcesz pobrać dane z konta Google Analytics do tego skryptu, możesz wybrać interfejs API Google Analytics^{(Google Analytics API)} , a następnie Dodaj^(Add) .

Jeśli chcesz znaleźć szczegółowe informacje o tym, jakie funkcje są dostępne dla tej nowej usługi dodatkowej i jak z nich korzystać, wybierz trzy kropki po prawej stronie interfejsu API^(API) i wybierz Zobacz dokumentację^{(See documentation)} .

Spowoduje to otwarcie dokumentacji Google Apps Script w nowej karcie, która zostanie automatycznie otwarta w sekcji dla tej usługi Google .

Zapoznaj się z dokumentacją dotyczącą składni funkcji, samouczków i przykładów kodu, których możesz użyć we własnym skrypcie.

Pamiętaj też, że możesz przejść do innych sekcji dokumentacji, aby zobaczyć, jakie ogólne funkcje są dostępne w skrypcie na podstawie usługi, z której korzystałeś podczas pierwszego otwierania edytora kodu Apps Script .

Jeśli na przykład otworzyłeś edytor w Arkuszach Google^{(Google Sheets)} , sprawdź sekcję Arkusze^(Sheets) w menu dokumentacji, aby znaleźć funkcje Arkuszy Google^{(Google Sheets)} , których możesz użyć w swoim skrypcie.

Konfigurowanie i używanie wyzwalaczy skryptów aplikacji^{(Using Apps Script Triggers)}

Kolejną przydatną funkcją w Google Apps Script jest możliwość ustawiania wyzwalaczy na podstawie wielu zdarzeń lub harmonogramów.

Aby skonfigurować nowy wyzwalacz dla skryptu, wybierz Wyzwalacze^(Triggers) z menu nawigacyjnego po lewej stronie. W nowym oknie wyzwalaczy^(Triggers) , które zostanie otwarte, wybierz przycisk Dodaj wyzwalacz^{(Add Trigger)} .

Okno Dodaj wyzwalacz^{(Add Trigger)} zawiera długą listę opcji, które pomagają dokładnie dostosować sposób i czas uruchamiania skryptu. 

Uwaga^(Note) : wiele z tych opcji zależy od usługi, dla której piszesz skrypt, lub dodanych interfejsów API^{(the APIs that you’ve added)} .

Aby skonfigurować wyzwalacz, musisz wybrać:

• Którą funkcję uruchomić na początku
• Źródło zdarzenia, takie jak konkretna godzina, data lub zdarzenie w Twojej usłudze, np. zmiana komórki arkusza kalkulacyjnego Google lub początkowe otwarcie dokumentu
• Typ zdarzenia, na przykład otwarcie lub edytowanie czegoś w arkuszu kalkulacyjnym lub dokumencie Google , lub określone ustawienie daty lub godziny
• Częstotliwość powiadomień informująca o tym, jak często chcesz otrzymywać informacje o niepowodzeniu Twoich skryptów

Po wybraniu opcji Zapisz^(Save) może pojawić się komunikat „ Autoryzacja skryptu^(Script) nie powiodła się”, jeśli po raz pierwszy zapisujesz nowy wyzwalacz.

Zwykle jest to wywoływane, jeśli masz włączoną blokadę wyskakujących okienek w przeglądarce. Jeśli używasz przeglądarki Google Chrome^{(Google Chrome)} , po prostu wybierz małą ikonę okna z czerwonym „X” nad nią. Zmień ustawienie na Zawsze zezwalaj na wyskakujące okienka^{(Always allow pop-ups)} i wybierz Gotowe^(Done) .

Gdy ponownie wybierzesz Zapisz^(Save) , musisz przejść przez cały proces autoryzacji napisanego skryptu do uruchomienia na Twoim koncie Google lub Google Workspace .

Najpierw wybierz konto Google , na którym chcesz zezwolić na uruchamianie skryptu.

Zobaczysz ostrzeżenie, że napisana przez Ciebie niestandardowa funkcja lub skrypt nie jest „zweryfikowany” przez Google . Jeśli to Ty napisałeś skrypt, nie ma to znaczenia i można go bezpiecznie uruchomić na własnym koncie^{(Google Account)} Google lub w Google Workspace .

Aby ominąć to ostrzeżenie, po prostu wybierz Zaawansowane^(Advanced) , a następnie wybierz łącze Go to <project> (unsafe) u dołu.

Na koniec w oknie uprawnień wybierz Zezwól^(Allow) , aby zezwolić na uruchamianie niestandardowych funkcji i skryptów na Twoim koncie Google lub Google Workspace .

Nie trzeba będzie powtarzać tego procesu ponownie, tylko przy pierwszym zapisaniu lub uruchomieniu niestandardowych projektów skryptów  Aplikacji Google .^{(Google Apps)}

Uzyskiwanie dostępu do Twojego identyfikatora skryptu Google

Ostatnia uwaga – możesz udostępnić swój skrypt znajomym lub współpracownikom, aby mogli użyć go lub dodać go jako bibliotekę do własnego skryptu. 

Możesz znaleźć swój identyfikator skryptu^{(Script ID)} pod ikoną Ustawienia^(Settings) w lewym okienku nawigacyjnym.

Identyfikator skryptu^{(Script ID)} można znaleźć w sekcji Identyfikatory^(IDs) po prawej stronie identyfikatora skryptu^{(Script ID)} .

Jak widać, edytor skryptów Google Apps^{(Google Apps Script)} jest dość prosty, jeśli wiesz, jak przejść do każdej funkcji, której chcesz użyć. Upewnij się tylko^(Just) , że dobrze zapoznałeś się z dokumentacją Google Apps Script , aby rozpocząć naukę pisania skryptów i wszystkich dostępnych funkcji.

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

If you use Google services like Google Docs, Google Ѕheets, Google Analytics, Gmail, and others, you could connect and automate those serviсes 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

• Jak eksperymentalne aplikacje Google mogą pomóc w walce z uzależnieniem cyfrowym

• 5 najlepszych aplikacji do filtrowania światła niebieskiego dla systemów Windows, Mac i Linux

• 5 przenośnych aplikacji, które zdecydowanie chcesz mieć na pamięci USB

• Autouzupełnianie Google Chrome: kompletny przewodnik

• 4 najlepsze aplikacje do przesyłania portów i jak z nich korzystać

• 4 świetne narzędzia do tworzenia pakietów Instalatora Windows

• 7 najlepszych narzędzi do usuwania Bloatware dla systemu Windows

• Xcode dla Windows (8 najlepszych narzędzi do tworzenia aplikacji na iOS na PC)

• Jak działają strony internetowe: dowiedz się, co kryje się pod maską

• Najlepsze 4 alternatywy dla Google Chromecast

• 11 najlepszych darmowych programów do tworzenia zrzutów ekranu dla systemu Windows

• 8 najlepszych darmowych aplikacji OCR do konwersji obrazów na tekst

• Najlepsze dodatki do ulepszenia pakietu Google Office

• 5 najlepszych narzędzi skanera IP dla systemów Windows, Mac, iOS i Android

• Google Draw: pełny przewodnik dla początkujących

• 5 sztuczek wiersza polecenia, które sprawią, że CMD będzie bardziej interesujący

• Parser e-maili Zapier: 3 kreatywne sposoby korzystania z niego

• 5 aplikacji do znajdowania i usuwania zduplikowanych plików w systemie Windows 10

• Najlepsze narzędzia do dostrajania procesora, karty graficznej i pamięci RAM

• 6 najlepszych aplikacji do sprawdzania temperatury procesora w systemie Windows 11/10