Google-apps-script

Скрипт Google Apps для разработчиков

Скрипт Google Apps упрощает интеграцию данных и функций из Gmail, Google Диска, Google Maps, YouTube и большинства других API Google. Apps Script — это внутренний JavaScript, поэтому вам не нужно изучать новый язык и вам не нужно управлять какими-либо серверами, поскольку весь ваш код выполняется в Google Cloud, а не в вашем браузере.
В этом видеоуроке вы узнаете, как разрабатывать проекты скриптов Google Apps локально на вашем компьютере в Visual Studio Code. Вы можете написать свой код на современном JavaScript, аккуратно организованном по модулям, а среда сборки будет использовать Babel и Webpack для преобразования вашего кода в версию JavaScript, совместимую с Apps Script.

Современная разработка с использованием скрипта Google Apps

Наличие локальной среды разработки дает немало преимуществ по сравнению с написанием кода в IDE Apps Script Cloud.

  1. Вы можете писать код с классами ES6, стрелочными функциями, модулями, разрушать и использовать все другие современные функции JavaScript.
  2. Опыт разработки внутри VS Code не имеет себе равных, а такие инструменты, как ESLint и Prettier упростит обнаружение ошибок на ранних этапах разработки.
  3. Процесс сборки и развертывания можно полностью автоматизировать с помощью сценариев npm и CLASP, утилиты командной строки Google для сценариев приложений.
  4. VS Code имеет встроенную поддержку Git и интегрируется с поставщиками системы контроля версий, такими как Github и Gitlab. Таким образом, легче отслеживать изменения и восстанавливать предыдущие версии кода.
  5. Вы можете быстро интегрировать в свой код библиотеки JavaScript, такие как LoDash, Moment, Underscore и любые пакеты NPM.
  6. Вы можете использовать современные фреймворки, такие как React, Vue.js и Angular, для создания интерфейса HTML, который подключается к бэкэнду с помощью клиентского API Google Script.

Начало работы со стартовым скриптом приложений

Стартовый комплект — это шаблон для быстрого начала разработки локальных скриптов приложений внутри VS Code. Откройте свой терминал и выполните следующие команды:
1 . клонировать репозиторий github в локальную папку
git clone https://github.com/labnol/apps-script-starter my-project
2 . Перейти в папку проекта
cd my-project
3 . Установить все зависимости и утилиты проекта
npm install
4 . Подключите CLASP к своей учетной записи Google
npx clasp login
5 . Создайте новый проект скрипта Google Apps на вашем Google Диске с помощью CLASP
npx clasp create --title "My Project" --rootDir./dist --type standalone
Эта команда создаст новый файл .clasp.json в папке вашего проекта, который связывает локальную папку с вашим проектом скрипта приложений. Во время сборки Webpack объединит весь ваш код в один файл JavaScript и добавит его в папку ./dist , которую Clasp отправит в ваш проект скрипта приложений.
Затем откройте папку текущего проекта в VS Code с помощью команды code. . Он включает в себя пример кода, но мы начнем с пустой папки, поэтому удалите все, что находится внутри папки src.
Внутри папки src создайте новый файл — email.js — и напишите простую стрелочную функцию, которая печатает список всех адресов электронной почты, подключенных к вашей учетной записи Gmail.

Затем создайте файл index.js (точка входа) в папке src, импортируйте функцию электронной почты, которую вы создали в файле email.js , и добавьте ее в глобальный объект. Это требование подключаемого модуля Webpack для скрипта Google Apps.
Вы также можете напрямую добавить выражение функции к глобальному объекту, например doGet в приведенном ниже примере.

Теперь, когда ваш код JavaScript готов, откройте файл appsscript.json в папке проекта и измените свойство oAuthScopes, чтобы включить только те области, которые требуются вашему проекту.
Далее перейдите в терминал командной строки и запустите команду развертывания, чтобы нажать код в проект скрипта приложений.
npm run deploy
Если вы развертываете проект впервые, вы получите сообщение «Файл манифеста обновлен. Вы хотите нажать и перезаписать? (да / нет) »- говорите« да ».
После завершения развертывания откройте связанный скрипт в браузере с помощью команды Open CLAP.
npx clasp open
Внутри редактора скриптов приложений Перейдите в меню «Запустить» и выберите функцию GetEMailAddress из списка. Откройте журналы, и вы должны увидеть ваши адреса электронной почты в окне.
Затем перейдите в меню «Опубликовать», выберите «Развернуть в качестве веб-приложения» и откройте URL на вкладке «Новый браузер», чтобы проверить вывод программы. Вот как легко создавать проекты с помощью Script Script Apps Google.

Использование Git со скриптом Google Apps

Создайте новый репозиторий в Github и запишите URL нового репозитория. Затем откройте терминал и запустите следующие команды, чтобы нажать проект скрипта приложений в GitHub.

Тот же подход используется Digital Inspiration для создания популярных надстроек Google, включая Gmail Mail Merge, Google Forms Notifications и Document Studio.