google-apps-script учебник
Начало работы с скриптом google-apps

замечания

Установка или настройка

Скрипт Google Apps не требует установки или установки. Единственное требование - учетная запись Google. Работает учетная запись Gmail, а также учетная запись Google Apps for Work / Education / Government. Вы можете создать новую учетную запись Google, перейдя на accounts.google.com.

Начните свой первый скрипт, перейдя на script.google.com . Вы также можете открыть Google Apps Script под tools -> Script editor... из многих Google Apps, то есть Документов, Таблиц, Форм и т . Д. Скрипт Google Apps также можно добавить прямо на Google Диск с помощью функции « Connect more apps.. .

Официальную документацию можно найти на developers.google.com/apps-script/ .

Для запуска сценариев приложений они должны содержать файл code.gs. Файл code.gs должен содержать функцию с именем doGet (автономные скрипты) или функцию onOpen (аддон-скрипты). Быстрые запуски в документации содержат примеры.

Если api включен в сценарии приложения, он также должен быть включен в консоли разработчика. Однако консоль разработчиков содержит api, которая может быть включена, но не отображается в интерфейсе приложения-скрипта. Например, SDK Marketplace необходимо включить в консоли разработчиков до того, как приложение может быть опубликовано в магазине воспроизведения Google или в широкомасштабном развертывании домена G Suite.

Для приложений Google для обучения / работы / правительства в консоли администратора домена есть настройки, которые можно настроить, чтобы разрешать или запрещать выполнение сценариев приложений.

Типы скриптов

Скрипты Google App имеют три типа.

• Standalone
• Связано с Google Apps
• Веб-приложения

Автономный скрипт

Автономные скрипты не привязаны ни к каким приложениям Google, а именно к документам, таблицам или формам и т. Д. Автономный скрипт можно создать, посетив script.google.com или подключив сценарий приложения Google с помощью Google диска. Автономный скрипт может использоваться для самостоятельного программирования приложений Google, может использоваться как веб-приложение или может быть настроен для автоматического запуска с установочного триггера. См. Документацию для автономного скрипта.

Связано с Google Apps

Сценарий, связанный с Google Apps, также известен как сценарий, связанный с контейнером; в отличие от автономных скриптов, привязаны к приложениям Google, то есть к Документам Google или Google Таблицам и т. д. Скрипт, связанный с контейнером, можно создать, выбрав tools> Script editor из Google App. Некоторые функции, такие как диалоги, подсказки, меню и боковая панель, предоставляются только сценариями, связанными с контейнерами. Кроме того, сценарий, связанный с контейнером, используется для создания надстроек Google . См. Документацию для сценариев, связанных с контейнером.

Веб-приложения

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

• включают функцию doGet() или doPost() .
• Функция возвращает объект HTML HtmlOutput HTML или объект TextOutput службы контента.

Функции Inshort, doGet() и doPost() работают как обработчики http get и post request соответственно.

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

Выполнение / отладка вашего скрипта

Попробуйте запустить свой код с панели инструментов, как показано ниже:

В вашем коде, если у вас есть несколько функций, перед запуском следует указать функцию, с которой вы хотите работать. Например :

Кроме того, вы можете нажать ctrl + r с клавиатуры, чтобы запустить код. Он сначала сохранит код, если не будет сохранен, а затем запустит его. Но для этого вам необходимо выбрать функцию, как показано на изображении выше.

Кроме того, если ваш сценарий вызывается некоторыми внешними действиями, все же вы сможете просмотреть журналы, щелкнув view-> logs, если вы регистрируете что-либо после выполнения кода.

Привет, мир

Мы собираемся сказать Hello как окно сообщения.

function helloWorld() 
{
  Browser.msgBox("Hello World");
}

Чтобы выполнить скрипт, нажмите ▶ или выберите пункт меню « Выполнить» -> helloWorld

Более глубокий взгляд на скрипт Google Apps

Скрипт Google Apps - это платформа, основанная на JavaScript, которая в первую очередь используется для автоматизации и расширения Google Apps. Скрипт приложений работает исключительно в инфраструктуре Google, не требующей настройки или конфигурации сервера. Онлайновая среда IDE служит интерфейсом для всей платформы, соединяющей все службы, доступные для скриптов приложений. Пользовательская аутентификация вызывается в платформу через OAuth2 и не требует никакого кода или настройки автором сценария.

Сценарий приложений работает на стороне сервера, но может иметь пользовательские интерфейсы, созданные с помощью HTML, CSS, JavaScript или любых других технологий, поддерживаемых браузером. В отличие от Nodejs, который управляется событиями, скрипты приложений выполняются в поточной модели. Все вызовы сценария генерируют уникальный экземпляр этого скрипта, который выполняется изолированно от всех других экземпляров. Когда экземпляр скрипта завершает выполнение, он уничтожается.

Функции в скрипте приложений блокируются, поэтому обратный вызов и шаблоны асинхронного программирования не нужны. Блокировка используется для предотвращения одновременного выполнения критических разделов кода, таких как файл IO, разными экземплярами.

На практике написания скриптов приложений просты. Ниже приведен простой скрипт, который создает новую таблицу из таблицы шаблонов.

// Create a new spreadsheet from a template
function createSpreadsheet(){
   var templateFileId = '1Azcz9GwCeHjGl9TXf4aUh6g20Eqmgd1UMSdNVjzIZPk';
   var sheetName = 'Account Log for:' + new Date();
   SpreadsheetApp.openById(templateFileId).copy(sheetName);   
}