Google apps script язык программирования

Введение

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Google Apps Script API позволяет программно создавать, изменять и развертывать проекты Apps Script — действия, которые в противном случае требуют использования редактора Apps Script. Ваши приложения могут использовать API для управления проектами сценариев, создания и развертывания новых версий сценариев, а также для мониторинга выполнения сценариев.

Предупреждение. Apps Script API не работает с сервисными аккаунтами .

API сценариев приложений также заменяет и расширяет API выполнения сценариев приложений. Вы можете использовать Apps Script API для удаленного выполнения функций Apps Script так же, как и с Execution API.

Примечание. Чтобы использовать этот API в своих приложениях, вы должны включить его для использования . Чтобы разрешить другим приложениям управлять вашими сценариями, вы должны предоставить им доступ .

Обзор API

Apps Script API разделен на несколько ресурсов, каждый из которых имеет определенную цель и набор запросов, которые вы можете сделать. Эти ресурсы следующие:

• projects — Представление проекта скрипта. API предоставляет методы для создания, чтения, мониторинга и изменения проектов.
• projects.deployments — представление развертывания скрипта. API предоставляет методы для создания, перечисления, обновления и удаления развертываний проектов сценариев.
• projects.versions — представление версии проекта скрипта. API предоставляет методы для создания и чтения версий проекта.
• processes — Представление выполнения функции скрипта. API предоставляет методы для составления списка существующих процессов и сбора информации о них, такой как тип и текущий статус.
• scripts — конечная точка, которая предоставляет методы для удаленного выполнения функций скриптов приложений.

Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons «С указанием авторства 4.0», а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.

Последнее обновление: 2023-04-14 UTC.

Источник

Google Apps Script — С чего начать изучение?

Главная » Блог » Google Apps Script — С чего начать изучение?

А вы слыхали про гугл скрипты (Apps Script)? Нет? Ну, как же так получилось? Ай-яй-яй! Такая полезная вещь, а о ней в курсе лишь узкий круг специалистов. А зря! Такая ситуация сложилась в русскоязычном сообществе, в англоязычном же интернет пространстве он довольно популярен (что видно из графиков ниже). Почему зря? А потому, что это прекрасный инструмент для малого и среднего бизнеса, который позволяет без лишних затрат оптимизировать документооборот и наладить автоматическую работу жизненно важных процессов предприятия. Та что там бизнес, каждый оценит по достоинству возможности этого сервиса, ведь способов применения просто бездна! Стоит немного вникнуть в кухню сервисов гугл, как, прям таки, перехватывает дыхание от открывающихся перспектив! Но не будем забегать вперед. Для начала необходимо разобраться что это такое и что с этим делать.

Google Apps script — что это?

Давным давно (с 2009 года) великий гугл выпустил полезную фичу — Google Apps script. Этот сервис дает возможность автоматизировать работу сервисов гугл. Самый близкий аналог — это офисный пакет Microsoft Office со своими макросами на VBA (Visual Basic for Applications) и его аналоги Libre Office, SoftMaker Office и т.п. Конечно, не совсем корректно сравнивать сравнвать GAS и VBA. Вот что об этом говорит один из ведущих специалистов по сервисам google в русскоязычном интернете, Александр Иванов.

Единственное, что их объединяет, это идея расширения возможностей табличного процессора за счет дополнительного программного кода. …

Ознакомится с более подробным сравнением, которое Александр любезно составил специально для нас с вами, можно по этой ссылке. Конечно, у многих, кто пытался с ходу освоить использование макросов могли остаться не слишком приятные воспоминания, однако не стоит сразу морщиться! Gooogle Apps script — куда более дружелюбно настроенный к пользователю язык, чем может показаться на первый взгляд. Фактически это язык сценариев на базе JavaScript (стандарта ECMAScript 5), придуманный специально для того чтобы существенно упростить разработку приложений на основе Google Apps. Для тех, кто в танке, напоминаю, что Google Apps (кстати, пакет недавно переименовали в G Suit) — это интернет-сервисы разработанные транснациональной корпорацией и с которыми в той или иной степени знаком каждый.

Сервисы гугл

и многие другие, список приложений постоянно растет (тут можно посмотреть весь список продуктов google).

Так вот, основные преимущества работы с гугл скриптами — это выполнение кода не на клиенте (т.е. непосредственно не на вашем рабочем компьютере), а в облаке Google.

Что дарит возможность создания автономных сценариев, для работы которых не требуется вмешательство пользователя (очень крутая фишка!).

Кроме того, для начала работы не требуется ничего устанавливать, Google уже обо всем позаботился.

Есть готовый редактор со всем необходимым функционалом (фото ниже).

К плюсам также можно причислить

• Достаточно низкий порог входа, т.е. легко обучаемый язык.
• Возможность взаимодействия и с другими службами Google, такими как AdSense, Google Analytics, AdWords и тп.
• Возможность создавать полноценные веб-приложения с графическим интерфейсом на HTML.
• Также возможность делать http-запросы и обрабатывать их результаты (парсинг). Тоесть с помощью класса UrlFetchApp в gas можно извлекать данные с веб-страниц и парсить XML/JSON ответы REST API сервисов.
• Достаточный функционал для создания простых инструментов, необходимых в работе предприятия, вплоть до полноценной CRM системы.
• Развитое комьюнити, в смысле, множество готовых решений и людей охочих подсказать и, конечно, документация. Правда все эти прелести в своем большинстве ориентированы на англоязычную публику.
• и многое другое.

Первый шаг — создание скрипта

Не будем ходить вокруг, да около… Напишем свой первый скрипт прямо сейчас.

Создание скрипта через панель инструментов Script Script

Для начала зайдите в свой аккаунт Google (напомним, что для доступа ко всем сервисам требуется только один аккаунт, который заводится вместе с гугловской почтой), а затем переходим по следующей ссылке script.google.com и попадаем на вот такую страницу (панель инструментов Script Script):

В левом боковом меню, кликните на кнопку + Создать скрипт.

Перед вами окно редактора гугл скриптов:

К слову, это не единственный способ его запуска.

Можно пойти и другим путем.

Создание скрипта через Google Диск

Клацаем на кнопочку Создать, выпадет список с вариантами, тут выбираем Еще и жмем на Подключить другие приложения.

В окошке подключений, в поиске, вводим Google Apps script клацаем Подключить и… вуаля!

В окне Приложение Google Apps Script добавлено на Google Диск., устанавливаем птицу напротив Выбрать Google Apps Script приложеним по умочанию для файлов, которые открываются с его помощью. и жмем на ок

Теперь в списке ваших возможностей появился новый сервис и мы можем приступать непосредственно к коду.

Создание скрипта через файл-контейнер

Кроме того существует еще один способ создать файл для сценария.

Это создание файла-сценария внутри файла-контейнера (например внутри таблицы, документа, слайда или формы, условно внутри).

Но этот способ мы разберем в следующих статьях.

Первый скрипт

Создаем свой первый скрипт.

Можно, конечно, сходить вот по этой ссылочке тыц и внимательно почитать что пишут знающие люди, или…

Не ходить, а просто отдаться в руки автора (т.е. в мои)) ) и читать дальше…

Тем, кто никогда не пробовал свои силы в программировании, наверняка, “лаконичное” окно редактора покажется совершенно загадочным и возможно некоторым даже захочется сбежать с криками: “Меня обманули, говорили, что это просто. ”

Не спешите смазывать лыжи! Это действительно просто, если, конечно, знать что делать.

Так уж повелось, еще на заре цифровых технологий, первым тестовым сообщением, которое выводит свеженаписанная программа это: “Привет мир!”.

Предлагаю чуть, отступить от канонов и вывести куда-нибудь сразу перевод знаменитого приветствия…ну, скажем, на суахили !

Для начала меняем название функции с myFunction на firstTest.

Далее пишем вот такую аБрА-КадабРу :

Давайте распишем тот же пример более подробно и разберем каждую строку

Строка 1. Директива function создает новую функцию, далее указываем ее название firstTest.

Затем в круглых скобках () указываем параметры которые хотим передать в функцию (в нашем случае мы ничего не указываем, так как ничего не передаем).

А в фигурных скобках <> указывается код который выполняется когда эта функция будт вызвана.

Если поставить два слеша //, то код после них и до конца строки выполнятся не будет.

Это называется комментарий.

К слову, комментарий еще можно указать так /* */, любой текст заключенный внутри будет считатся комментарием, независимо от начала и/или конца строк(и).

Строки 2-4. Объявляем переменные с помощью директивы var.

• Переменная text со значением “Hello World!” — это текст, который требуется перевести,
• text_language со значением “en” — код языка на котором написан текст, если оставить его пустым (вот так “”), язык будет определяться автоматически,
• И language_of_translation со значением “sw” — код языка на который будет переведен текст.

(коды языков можно подсмотреть здесь)

var text = "Hello World!", text_language = "en", language_of_translation = "sw";

Строки 6-10. Обращаемся к объекту LanguageApp, а точнее к методу этого объекта translate, который принимает три параметра (их мы уже описали выше в строках 2-4).

Если некоторые термины вам непонятны и/или у вас нет базовых знаний JavaScript или другого языка, не расстраивайтесь!

В конце статьи я дам ссылку на простой учебник по JS.

Результат

Результатом работы этого метода будет — переведенный текст, который, в нашем случае, записывается в переменную text (то есть перезаписываем старое значение на новое).

text = LanguageApp.translate( text, text_language, language_of_translation );

Строка 12. Logger.log( text ) — это вывод нашего текста в журнал, где потом мы и будем его смотреть.

К слову, данный способ ( Logger.log(); ) в будущем не раз пригодится для отладки ваших сценариев, т.е. поиска и устранения ошибок, закравшихся в ваш сценарий.

Строка 14. Необязательная директива return — возвращает данные, указанные поле нее (мы ничего не указали, а это значит что по умолчанию возвратится false, с таким же успехом данную директиву можно было не указывать).

Продолжим, наша программа написана, теперь сохраним ее нажав на эту кнопку (иконка дискеты)

К вам тут же выскочит окошко.

В нем вводим название проекта в поле Укажите новое название проекта, пусть будет Привет мир!. Затем жмем на кнопку ok

Теперь запустим ее, сначала выбрав нужную функцию а затем нажав на вот тут (иконка треугольник)

И наконец, идем во вкладку Вид > Журналы или просто нажимаем Ctrl+Enter (горячии клавиши полезная штука).

И вот результат наших стараний…

Синим подчеркнута информация, сообщающая когда была сделана запись,

а красным наше содержимое переменной text.

Да, да — Salamu, Dunia! И есть перевод знаменитого Hello World на суахили.

Задача выполнена!

Овации! Чувствуете гордость? Совершенно заслуженно.

Мы с вами сделали первый шаг к освоению замечательного инструмента.

Согласитесь, без ложной скромности, что это было не так уж и сложно.

Остались вопросы?

Вы всегда можете задать их в комментариях к данному посту.

Да и поэкспериментируйте с кодом, а потом покажите нам его в комментариях.

Итоги

А теперь, коротко, подведем итоги:

• Установка сервиса GAS простая процедура, которая займет меньше минуты.
• Запустить редактор скриптов можно по ссылке script.google.com
• LanguageApp.translate(text, sourceLanguage, targetLanguage); — автоматически переводит текст с исходного языка на целевой язык, он принимает 3 параметра: исходный текст, язык текста, язык перевода.
• Журнал очень полезен для отладки сценариев.
• Salamu, Dunia! — Hello World на суахили.
• GAS — не так все сложно, как кажется.

Надеюсь мне удалось донести мысль, что Google Apps Script удивительно полезный инструмент, на изучение которого стоит потратить время.

А дальше больше!

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

То бишь, все эти кнопочки, вкладочки и т.п.

Сделав первый шаг к цели, не стоит останавливаться. Как гласит древняя мудрость:

Дорога…

…. возникает….

… под шагами идущего…

Полезные ссылки и источники

• Панель инструментов Google Script (на английском)
• Основы JavaScript
• Чтобы получить мнение или поговорить о проблеме, с которой вы сталкиваетесь, я рекомендую вам размещать сообщения в сообществе на Telegram или на Stack Overflow

Источник