Если вы используете службы Google, такие как Google Docs , Google Sheets , Google Analytics , Gmail и другие, вы можете подключить и автоматизировать эти службы с помощью Google Apps Script . 

Думайте о сценарии Google Apps^{(Google Apps Script)} как о версии Google для сценария VBA от Microsoft^{(Microsoft’s VBA script)} . Точно так же, как вы можете автоматизировать действия и задачи или настраивать макросы в Microsoft Word и Excel с помощью VBA^{(Excel with VBA)} , вы можете автоматизировать задачи и действия в службах Google . В таких сервисах, как Sheets и 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 в меню « Расширения»^(Extensions) в Google Sheets.

В других сервисах вы можете открыть редактор скриптов Google Apps следующими способами:^{(Google Apps Script)}

• Документы Google^{(Google Docs)} : выберите Редактор сценариев^{(Script editor)} в меню Инструменты .^(Tools)
• Google Презентации^{(Google Slides)} : выберите Редактор сценариев^{(Script editor)} в меню Инструменты .^(Tools)
• Google Forms : выберите Редактор скриптов^{(Script editor)} в трехточечном меню.
• Google Диск^{(Google Drive)} : щелкните правой кнопкой мыши любое пустое место, выберите « Еще^(More) » и выберите «Скрипт Google Apps^{(Google Apps Script)} » .

Используя любой из этих методов, вы увидите редактор кода Apps Script , открытый на новой вкладке. Это окно, в котором вы будете писать каждую из функций, составляющих весь ваш сценарий. По умолчанию вы увидите пустую функцию с именем myFunction(), которая готова к тому, чтобы вы начали заполнять свой код.

Примечание^(Note) . Форматирование кода очень важно, чтобы избежать ошибок. Используйте комментарии, как показано в следующем коде, чтобы напомнить себе, что вы пытались сделать внутри разделов кода. Это очень похоже на то, как комментирование работает в HTML -коде при веб-программировании.

При перемещении по редактору кода вы можете вернуться в этот раздел, выбрав Code.gs на левой панели навигации в окне редактора^(Editor) . Чтобы увидеть другие доступные окна, наведите указатель мыши на значки в крайней левой панели, и откроется основная панель навигации.

В разделе « Обзор^(Overview) » вы можете найти статистику о вашем скрипте, например, сколько ошибок произошло, сколько раз он выполнялся и т. д.

Мы рассмотрим каждый из других разделов редактора скриптов Google Apps в каждом разделе ниже.^{(Google Apps Script)}

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

Когда вы редактируете свой код в редакторе, рекомендуется часто нажимать значок диска ( Сохранить^(Save) ), чтобы не потерять свою работу.

После сохранения вы увидите, как загораются другие пункты меню. 

Это включает:

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

Параметр « Библиотеки^(Libraries) » в левом навигационном меню — это место, где вы можете получить доступ к библиотекам, которые написали другие люди (или вы написали и сохранили в другом месте). Это полезно, если у вас есть друг, который уже написал функцию, которую вы хотели бы использовать в Google Sheets или Google Docs , но вы хотели бы добавить к ней дополнительные функции.

Все, что вам нужно для добавления этих библиотек в ваш проект, — это идентификатор сценария^{(Script ID)} . Вы можете найти это в разделе настроек проекта, который мы покажем вам, как найти в конце этой статьи.

Надстройки Google Apps Script Services

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

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

Например, если вы хотите извлечь данные из своей учетной записи Google Analytics в этот скрипт, вы можете выбрать API Google Analytics^{(Google Analytics API)} и нажать кнопку Добавить^(Add) .

Если вы хотите найти подробную информацию о том, какие функции доступны для использования для этой новой надстройки и как их использовать, выберите три точки справа от API и выберите См. документацию^{(See documentation)} .

Откроется документация по скрипту Google Apps^{(Google Apps Script)} на новой вкладке, которая автоматически откроется в разделе для этой службы Google .

Изучите документацию по синтаксису функций, руководствам и примерам кода, которые вы можете использовать в своем собственном скрипте.

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

Например, если вы открыли редактор в Google Sheets , проверьте раздел Sheets в меню документации для функций ^(Sheets)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 , просто выберите значок маленького окна с красным крестиком над ним. Измените настройку на « Всегда разрешать всплывающие окна^{(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)} под значком « Настройки^(Settings) » в крайней левой панели навигации.

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

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

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

If you use Google services like Google Dоcs, Google Sheets, Googlе Analytics, Gmail, and others, you could connect аnd automate those services using Gоogle 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

• Как экспериментальные приложения Google могут помочь вам бороться с цифровой зависимостью

• 5 лучших приложений для фильтрации синего света для Windows, Mac и Linux

• 5 портативных приложений, которые вы обязательно захотите иметь на USB-накопителе

• Автозаполнение Google Chrome: полное руководство

• 4 лучших приложения для переадресации портов и способы их использования

• Лучшие приложения для мониторинга использования Интернета

• Лучшие надстройки для расширения возможностей вашего офисного пакета Google

• 5 лучших инструментов для сканирования IP-адресов для Windows, Mac, iOS и Android

• Как приложение Signal для ПК может защитить вашу конфиденциальность

• Как использовать диспетчер пакетов Windows для установки программ Windows

• 4 лучших сторонних приложения для Windows 10, которые вы должны установить прямо сейчас

• Что нужно учитывать перед созданием собственной вики

• Как использовать Диспетчер тегов Google для анализа трафика вашего сайта

• Парсер электронной почты Zapier: 3 творческих способа его использования

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

• Как проверить, не слишком ли высока температура вашего процессора

• Работает ли Microsoft Windows File Recovery? Мы протестировали это.

• Автоматически перемещать, удалять или копировать файлы в Windows

• 5 лучших программ для управления двумя мониторами

• 7 лучших инструментов для удаления вредоносных программ для Windows