Використання Google Apps Script для розробки веб-додатків

3 ОПИС РОЗРОБКИ ВЕБ-ДОДАТКІВ З ВИКОРИСТАННЯМ
GOOGLE APPS SCRIPT
3.1 Опис структури та складових веб-додатків 
Якщо створити інтерфейс користувача для скрипта, то можна опублікувати 
сценарій як веб-програму. Іноді скрипт доцільніше представити як веб-програму, 
щоб користувачі могли отримати до неї доступ безпосередньо зі своїх браузерів. 
Доступ до додатку здійснюється за спеціальною URL-адресою, розміщеною в хмарі 
Google. 
Як вже було вказано в попередньому розділі, і автономні скрипти, і прив’язані до 
Google Apps скрипти можна перетворити на веб-додатки. 
Сценарій можна опублікувати як веб-програму, якщо він відповідає таким 
вимогам: 
•
Він містить функцію doGet() або doPost(). 
•
Функція повертає об’єкт служби HTML HtmlOutput або об’єкт служби вмісту 
TextOutput.
Функції doGet() та doPost() працюють як обробники HTTP -запитів GET і POST. 
Веб-додатки повинні мати функцію doGet() для Google, щоб перехоплювати, коли 
спеціальна URL-адреса Google для додатка завантажується в браузері. Коли 
користувач відвідує веб-додаток або програма надсилає веб-додатку GET-запит, 
Apps Script запускає функцію doGet(). doGet() є відправною точкою, яка завантажує 
видимі елементи в інтерфейсі веб-додатку, вона повідомляє серверу, що він повинен 
почати виконувати скрипт саме тут. 
Коли програма надсилає веб-додатку POST-запит, замість нього запускається 
Apps Script doPost(). 
В обох випадках аргумент, який передається у функцію, представляє собою 
параметр події, який може містити інформацію про будь-які параметри запиту.
 
 

3.2 Опис процесу розробки веб-додатків з використанням Google Apps 
Script 
Планування 
Першим кроком у розробці веб-додатків з використанням Google Apps Script є 
визначення мети та які завдання або операції має виконувати додаток, і які сервіси 
Google (наприклад, Google Sheets, Google Docs, Google Calendar) будуть 
використовуватися. 
Створення проекту 
Після планування можна перейти до створення нового проекту в середовищі 
розробки Google Apps Script. Для цього є два способи. Перший – перейти 
безпосередньо на сайт script.google.com та натиснути у верхньому лівому куті 
«Новий проект». Другий – створити автономний скрипт з Google Диска: перейти на 
Диск Google, натиснути у верхньому лівому куті «Створити» > «Більше» > «Google 
Apps Script». 
Розробка коду 
Наступним кроком буде створення інтерфейсу користувача. 
Google Apps Script HTML Service дозволяє вставляти HTML-код безпосередньо в 
скриптовий код. Можна використовувати HTML та JavaScript для створення більш 
складних інтерфейсів. Цей підхід також дозволяє зв'язувати HTML-елементи зі 
скриптовим кодом та взаємодіяти з ним через спеціальні функції. 
Зазвичай, в Google Apps Script для написання коду використовуються файли з 
розширенням .gs (Google Script). Google Apps Script надає можливість писати 
стандартні HTML-файли, які використовують загальні елементи, що зустрічаються 
на будь-якій сучасній веб-сторінці, такі як jQuery і CSS. 
Щоб створити HTML-файл, треба натиснути на плюс на елементі "Файли" і 
вибрати "HTML". 

Рисунок 5 – Створення HTML-файлу 
Далі файл потрібно назвати. В результаті створиться новий файл з розширенням 
.html, в якому буде згенерований базовий код структури html-сторінки, що включає 
заголовок і тіло. 
Рисунок 6 – Згенерований HTML -файл 
Оскільки Google Apps Script використовує мову програмування JavaScript (хоч і 
не найновішу версію), можна писати код на JavaScript для визначення 
функціональності додатка. Також можна використовувати вбудовані сервіси Google 
Apps Script, такі як SpreadsheetApp (для роботи з Google Таблицями), DocumentApp 
(для роботи з Google Документами) та CalendarApp (для роботи з Google 
Календарем), а також використовувати власні функції та бібліотеки. 
Тестування та налагодження 
Google Apps Script надає набір інструментів та функціональності для 
налагодження коду. Розробнику доступні засоби для відстеження змін, 
використання точок зупину, перевірки значень змінних та інші. За допомогою 
засобів налагодження можна «крокувати» по коду, виконуючи його по одному 

рядку. Це дозволяє контролювати виконання програми та перевіряти, як вона 
поводиться на кожному кроці. 
Щоразу, коли розробник зберігає скрипт, Google перевіряє код на наявність 
синтаксичних помилок. Редактор сценаріїв повідомить, що була пропущена 
закриваюча дужка або є зайва лапка, але не може повідомити, що змінна не 
визначена або не вдалося отримати доступ до веб-сервісу. Ця перевірка помилок 
відображається у верхній частині сторінки червоним кольором з помилкою і 
номером рядка, в якому виникла помилка. 
Як і більшість об'єктно-орієнтованих мов програмування, Google Apps Script 
використовує оператор «try/catch» для роботи з помилками під час виконання. Варто 
зазначити, що браузер також повертатиме помилки, але за допомогою «try/catch» 
можна отримати більш детальну інформацію. 
Google Apps Script надає можливість перегляду змін в додатку після їх 
збереження в редакторі. Для цього серед опцій введення в дію потрібно вибрати 
«Тестувати пакети». 
Рисунок 7 – Опції введення в дію 
Опісля з’явиться нове вікно, де буде URL-адреса веб-додатку, яка закінчується 
на /dev. Це версія для розробки, яка відображає код у тому вигляді, в якому він є у 
редакторі, щоразу, коли розробник зберігає код. Щоб отримати URL-адресу для 
тестування, треба хоча б раз ввести веб-додаток в дію. 

Рисунок 8 – Налаштування тестування 
Публікація 
Щоб опублікувати додаток, потрібно натиснути кнопку "Ввести в дію" і серед 
опцій вибрати "Нове введення в дію".
Відкриється діалогове вікно «Нове введення в дію», в якому треба вибрати опцію 
«Веб-додаток».
Рисунок 9 – Вибір типу проекту 
В переліку налаштувань з’являться декілька важливих опцій. Поле «Опис» 
відповідає за інформацію про версію додатка. «Виконати від імені» дозволяє 
вибрати, як запускати веб-додаток: від імені розробника чи від імені користувача, 
який запускатиме додаток. 

Рисунок 10 – Налаштування виконання веб-додатка 
Коли програма працює від імені розробника, вона отримує доступ до його даних. 
Якщо метою є створення додатка, який буде розповсюджений серед інших 
користувачів для розширення їхніх Google Apps, то краще, щоб додаток працював 
від їхнього імені і мав доступ до їхніх даних.
Запуск сценарію від імені автора може бути корисним, оскільки він може 
обмежити спільний доступ до електронної таблиці, а потім контролювати, які дані 
бачить програма для перегляду інтерфейсу, дозволяючи при цьому вводити 
користувачам дані в таблицю. Одним з обмежень запуску скрипта від імені автора є 
те, що він не може отримати прямий доступ до облікового запису користувача з 
вбудованих класів. Наприклад, якщо веб-додатку потрібно отримати доступ до 
Google Контактів користувача, це не спрацює.
Далі потрібно визначити, хто може користуватися додатком. Дана опція 
стосується тільки веб-додатка, а не скрипту.

Рисунок 11 – Налаштування доступу 
Опція «Усі» дозволить веб-додатку працювати без входу користувача в обліковий 
запис Google. 
Налаштування «Виконати від імені» та «Хто має доступ» можна змінити у будь-
який час. 
Після налаштування веб-додатку, наступним кроком буде «Ввести в дію». На 
екрані з'явиться нове вікно. 

Рисунок 12 – Введення в дію 
Це поле містить поточну URL-адресу веб-додатка, за якою можна перейти і 
переглянути поточну версію веб-додатка, яка була встановлена в попередньому 
вікні.
Варто зазначити, що публікація не дозволяє користувачам веб-додатка отримати 
доступ до коду; це контролюється налаштуваннями спільного доступу в редакторі 
сценаріїв або контейнері, якщо веб-додаток публікується з нього. Це означає, що код 
залишатиметься надійно захищеним. 
Підтримка та оновлення 
Після розгортання веб-додатка важливо забезпечити підтримку та проводити 
оновлення відповідно до потреб користувачів. Це може включати виправлення 

помилок, вдосконалення функціональності, додавання нових можливостей та 
забезпечення безпеки веб-додатка. 

жүктеу/скачать 1,77 Mb.

Достарыңызбен бөлісу: