Ако използвате услуги на Google като Google Docs , Google Sheets , Google Analytics , Gmail и други, можете да свържете и автоматизирате тези услуги с помощта на Google Apps Script . 

Мислете за Google Apps Script като за версията на Google на VBA скрипта на Microsoft^{(Microsoft’s VBA script)} . Точно както можете да автоматизирате действия и задачи или да персонализирате макроси в Microsoft Word и Excel с VBA^{(Excel with VBA)} , можете да автоматизирате задачи и действия в услугите на Google . В услуги като Таблици и Документи^(Docs) можете дори да напишете свои собствени персонализирани менюта.

В тази статия ще научите как да осъществите достъп и да активирате Apps Script във вашите различни услуги на Google^{(various Google services)} , как да навигирате в Apps Script Editor и как да свържете услуги. Няма да научите специфични функции на скрипт^{(learn specific script functions)} , но Google разполага с отлична документация и уроци за скриптове за приложения, за да научите как да пишете Apps Script .

Как да получите достъп до редактора на скриптове на Google Apps^{(Access Google Apps Script Editor)}

Можете да отворите редактора на кодове на Google Apps Script от редица услуги на ^{(Google Apps Script)}Google . Например, ще намерите Apps Script в менюто Разширения^(Extensions) в Google Sheets.

В други услуги можете да отворите редактора на Google Apps Script по следните начини:^{(Google Apps Script)}

• Google Документи^{(Google Docs)} : Изберете Редактор на скриптове^{(Script editor)} в менюто Инструменти .^(Tools)
• Google Slides : Изберете Редактор на скриптове^{(Script editor)} в менюто Инструменти .^(Tools)
• Google Forms : Изберете редактор на скриптове^{(Script editor)} в менюто с три точки.
• Google Диск^{(Google Drive)} : Щракнете с десния бутон върху празно място, изберете Още^(More) и изберете Google Apps Script .

Като използвате някой от тези методи, ще видите как редакторът на код на Apps Script се отваря в нов раздел. Това е прозорецът, в който ще напишете всяка от функциите, които съставляват целия ви скрипт. По подразбиране ще видите празна функция с име myFunction(), която е готова да започнете да попълвате кода си.

Забележка^(Note) : Форматирането на кода е много важно, за да се избегнат грешки. Използвайте коментарите, както е показано в следния код, за да си напомните какво се опитвате да направите в секции от кода. Това е много подобно на начина, по който работи коментирането в HTML код с уеб програмиране.

Докато навигирате в редактора на кодове, можете да се върнете към този раздел, като изберете Code.gs в левия навигационен панел в прозореца на редактора^(Editor) . За да видите други налични прозорци, задръжте курсора на мишката върху иконите в крайния ляв прозорец и главният навигационен панел ще се отвори.

Разделът Общ преглед^(Overview) е мястото, където можете да намерите статистически данни за вашия скрипт, като например колко грешки са възникнали, колко пъти е изпълнен и др.

Ще разгледаме всяка от другите секции на редактора на Google Apps Script във всеки раздел по-долу.^{(Google Apps Script)}

Навигиране в редактора на скриптове на Google Apps^{(Google Apps Script Editor)}

Докато редактирате кода си в редактора, е добре да избирате често иконата на диска ( Save ), за да не загубите работата си.

След като запазите, ще видите, че другите опции на менюто светят. 

Те включват:

• Run : Опитайте се да изпълните целия си скрипт от началото до края.
• Отстраняване^(Debug) на грешки : Преминете през вашия скрипт един ред по ред.
• Падащо меню за функции^{(Function dropdown)} : Разгледайте и навигирайте до всяка от функциите, които сте създали.
• Регистър на изпълнението^{(Execution log)} : Вижте всички съобщения за състояние или грешки от всеки опит, който сте направили да изпълните вашия скрипт.

Опцията Библиотеки^(Libraries) в лявото навигационно меню е мястото, където можете да получите достъп до библиотеки, които са написали други хора (или вие сте написали и запазили другаде). Това е полезно, ако имате приятел, който вече е написал функция, която искате да използвате в Google Таблици^{(Google Sheets)} или Google Документи^{(Google Docs)} , но искате да добавите допълнителни функции отгоре на това.

Всичко, от което се нуждаете, за да добавите тези библиотеки към вашия проект, е Script ID . Можете да намерите това в секцията за настройки на проекта, която ще ви покажем как да намерите към края на тази статия.

Добавки за услуги за скриптове на Google Apps

Разделът Услуги^(Services) е най-полезен. Това е мястото, където можете да интегрирате текущия си скрипт с други услуги на Google , които може да използвате. 

Когато го изберете, ще видите отворен прозорец Добавяне на услуга . ^{(Add a service)}Превъртете^(Scroll) надолу до услугата, която искате да използвате като добавка към съществуващия си проект. 

Например, ако искате да изтеглите данни от профила си в Google Анализ^(Analytics) в този скрипт, можете да изберете API на Google Анализ^{(Google Analytics API)} и да изберете Добавяне^(Add) .

Ако искате да намерите подробности за това какви функции са налични за използване за тази нова услуга за добавки и как да ги използвате, изберете трите точки вдясно от API и изберете Вижте документацията^{(See documentation)} .

Това ще отвори документацията на Google Apps Script в нов раздел, отворен автоматично в секцията за тази услуга на Google .

Разгледайте документацията за синтаксис на функциите, уроци и примери за код, които можете да използвате във вашия собствен скрипт.

Също така имайте предвид, че можете да отидете до други раздели на документацията, за да видите какви общи функции са налични във вашия скрипт въз основа на услугата, която сте използвали, когато първоначално сте отворили редактора на кода на Apps Script .

Например, ако сте отворили редактора в Google Таблици^{(Google Sheets)} , проверете секцията Таблици^(Sheets) в менюто за документация за функциите на Google Таблици^{(Google Sheets)} , които можете да използвате във вашия скрипт.

Настройка и използване на тригери за скриптове на приложения^{(Using Apps Script Triggers)}

Друга полезна функция в Google Apps Script е възможността да задавате тригери въз основа на редица събития или графици.

За да конфигурирате нов тригер за вашия скрипт, изберете Тригери^(Triggers) от най-лявото навигационно меню. В новия прозорец с тригери^(Triggers) , който се отваря, изберете бутона Добавяне на тригер^{(Add Trigger)} .

Прозорецът Добавяне на тригер^{(Add Trigger)} има дълъг списък с опции, които ви помагат да персонализирате точно как и кога искате да се изпълнява вашият скрипт. 

Забележка^(Note) : Много от тези опции зависят от услугата, за която пишете своя скрипт, или API, които сте добавили^{(the APIs that you’ve added)} .

За да настроите задействането си, ще трябва да изберете:

• Коя функция да стартира първоначално
• Източникът на събитие, като конкретен час, дата или събитие във вашата услуга, като например когато клетката на електронна таблица на Google се промени или документът е първоначално отворен
• Типът събитие, като например когато нещо във вашата електронна таблица или документ в Google е отворено или редактирано, или конкретната настройка за дата или час
• Честота на уведомяване за това колко често искате да получавате актуализации за случаите, когато вашите скриптове са се провалили

След като изберете Запиши^(Save) , може да видите съобщение „ Оторизирането на скрипт^(Script) не бе успешно“, ако за първи път сте запазили ново задействане.

Това обикновено се задейства, ако имате активиран блокер на изскачащи прозорци във вашия браузър. Ако използвате Google Chrome , просто изберете иконата на малък прозорец с червено „X“ над нея. Променете настройката на Винаги разрешаване на изскачащи прозорци^{(Always allow pop-ups)} и изберете Готово^(Done) .

Когато изберете Запазване^(Save) отново, ще трябва да преминете през процеса, за да разрешите скрипта, който сте написали, да се изпълнява под вашия акаунт в Google или Google Workspace .

Първо изберете акаунта в Google , под който искате да разрешите на вашия скрипт да се изпълнява.

Ще видите предупреждение, че персонализираната функция или скрипт, който сте написали, не е „проверен“ от Google . Ако вие сте човекът, който е написал скрипта, това няма значение и е безопасно да работите под собствения си акаунт в Google^{(Google Account)} или Google Workspace .

За да заобиколите това предупреждение, просто изберете Разширени^(Advanced) и след това изберете връзката Go to <project> (unsafe) в долната част.

И накрая, в прозореца с разрешения изберете Разрешаване^(Allow) , за да разрешите на вашите персонализирани функции и скрипт да се изпълняват под вашия акаунт в Google или Google Workspace .

Няма да се налага да повтаряте този процес отново, само първия път, когато запазите или стартирате вашите персонализирани проекти за скриптове  на Google Apps .

Достъп до вашия Google Script ID

Една последна забележка – може да искате да предоставите своя скрипт на приятели или колеги, за да могат или да използват вашия скрипт, или да го добавят като библиотека към своя собствен скрипт. 

Можете да намерите своя идентификатор на скрипта^{(Script ID)} под иконата Настройки^(Settings) в крайния ляв навигационен панел.

Идентификационният номер на скрипта^{(Script ID)} може да бъде намерен под секцията IDs , вдясно от Script ID .

Както можете да видите, редакторът на Google Apps Script е доста ясен, ако знаете как да навигирате до всяка функция, която искате да използвате. Просто^(Just) не забравяйте да проучите добре документацията на Google Apps Script , за да можете да започнете да се учите как да пишете вашите скриптове и всички функции, които са налични за използване.

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

If you use Google serviсes like Google Docs, Google Sheets, Google Analytics, Gmail, аnd others, yoυ could connect and automate thosе services using Google Apps Scrіpt. 

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

• Как експерименталните приложения на Google могат да ви помогнат в борбата с цифровата зависимост

• 5-те най-добри приложения за филтриране на синя светлина за Windows, Mac и Linux

• 5 преносими приложения, които определено искате да имате на вашия USB флаш

• Автоматично попълване на Google Chrome: Пълно ръководство

• 4 най-добри софтуерни приложения за пренасочване на портове и как да ги използвате

• Google Translate срещу Bing Translate – кой е най-добрият?

• Настройки на съдържанието на Google Chrome: пълно ръководство

• Електронно обучение за деца – най-добрите приложения и инструменти за обучение на децата ви у дома

• Автоматично преместване, изтриване или копиране на файлове в Windows

• 7 най-добри приложения за рисуване за Windows

• 8 най-добри безплатни софтуерни приложения за OCR за конвертиране на изображения в текст

• Xcode за Windows (8 най-добри инструменти за разработване на iOS приложения на компютър)

• Коя е най-добрата услуга за конферентни разговори – най-добрите сравнени приложения

• Как да използвате Google Tag Manager, за да анализирате трафика на вашия уебсайт

• Как да копирате вашите DVD и Blu-Ray файлове без усилие с MakeMKV

• 7 най-добри инструмента за премахване на раздуващ софтуер за Windows

• Най-добрите приложения за WiFi анализатор за Windows, iOS, macOS и Android

• 4 най-добри приложения на трети страни за Windows 10, които трябва да инсталирате сега

• Какво представлява Microsoft Power Automate и безплатни шаблони за изтегляне

• Най-добри редактори на Markdown: всички платформи и онлайн