Основы использования

function FirstExampleFunc() 
{
    Browser.msgBox("Это таки JS! ");
}

Рис. 1. Стартовое окно редактора скриптов

function menu() 
{
     var ss = SpreadsheetApp.getActiveSpreadsheet();
     var entries = [ {name: "Моя единственная функция", functionName: "FirstExampleFunc"},
     ss.addMenu("Мои функции", entries);
}

Рис. 2. Редактор кода, заполненный автогенерируемым сырьевым материалом для работы с электронной таблицей

Рис. 3. Вызов пользовательской функции с аргументом

Работа с Google Docs

var ss = SpreadsheetApp.getActiveSpreadsheet();    
var sheet = ss.getSheets()[0];
sheet.getRange("A1").setValue("Содержимое ячейки");

var source = DocsList.getFileById("SOURCE_ID");
var newFile = source.makeCopy("новое имя файла");
var targetFolder = DocsList.getFolderById("ID папки, в которой будет размещен свежесозданный файл");
newFile.addToFolder(targetFolder);

var doc = DocumentApp.openById("ID редактируемого документа");
doc.editAsText().replaceText("старый текст", "новый текст");
Logger.log(doc.getText())

var doc = DocumentApp.openById('id документа');
var textToHighlight = 'текст для подсветки';
var highlightStyle = {};
highlightStyle[DocumentApp.Attribute.FOREGROUND_COLOR] = '#FF0000';
var paras = doc.getParagraphs();
var textLocation = {}; 
for (i=0; i<paras.length; ++i)
{
    textLocation = paras[i].findText(textToHighlight);
    if (textLocation != null && textLocation.getStartOffset() != -1)
    {
        textLocation.getElement().setAttributes(textLocation.getStartOffset(),textLocation.getEndOffsetInclusive(), highlightStyle);
    }
}

Рис. 4 Вот здесь можно узнать ID документа

• Google Apps Script References для Google Doсument
• Google Apps Script References для Google Spreadsheet

Работа с почтой

 var sheet = SpreadsheetApp.getActiveSheet();
 var numRows = sheet.getLastRow(); 
 var dataRange = sheet.getRange(1, 1, numRows, 2)
 var data = dataRange.getValues();
 for (var i = 0; i < data.length; ++i) 
 {
     var row = data[i];
     var name = row[0]; 
     var email = row[1];    
     var subject = "Тема письма";
     var message = "Здравствуйте, " + name + "!";   
     MailApp.sendEmail(email, subject, message);
}

var threads = GmailApp.search('enemy@example.com');
for(var i = 0; i < threads.length; i++)
{
      var messages = threads[i].getMessages();
      for(var j = 0; j < messages.length; j++)
      {
           messages[j].moveToTrash();
      }
}

Работа с Google Translate

var word = LanguageApp.translate('кукушка', 'ru', 'es');
Logger.log(word);
// Скрипт выведет в консоль "cuco" — кукушка по-испански

Работа с Google Drive

var files = DriveApp.getFiles();
while (files.hasNext()) {
  var file = files.next();
  Logger.log(file.getName());
}

• addEditor(«email пользователя») — наделяет пользователя правами на редактирование файла;
• getOwner() — узнать владельца файла;
• makeCopy(«имя», «путь») — создать копию файла;
• getLastUpdated() — возвращает пользователя, который внес последнее изменение.

Работа с Google Contacts

var group = ContactsApp.getContactGroup("Редакция");
var contacts = group.getContacts();
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheetByName("Контакты редакции");
for (var i in contacts) {
 // Сохраняем данные о контактах в ячейки: имя, фамилия, номер телефона
 sheet.getRange(i, 1, 1, 1).setValue(contacts[i].getGivenName());
 sheet.getRange(i, 2, 1, 1).setValue(contacts[i].getFamilyName()); 
 sheet.getRange(i, 3, 1, 1).setValue(contacts[i].getPhones());     
// И еще есть метод для получения номера пейджера (!) контакта
 sheet.getRange(i, 4, 1, 1).setValue(contacts[i].getPager());     
  }

Работа с Google Tasks

// Найти ID тасклиста можно внутри адресной строки в сервисе Google Task
    var taskListId="id тасклиста,";
     var newTask = {
            title: 'Выбросить финиковые косточки',
            notes: 'Не забыть косточки под кроватью'
         };
  newTask = Tasks.Tasks.insert(newTask , taskListId);
  Logger.log ("Задача с ID "%s" создана", newTask.id);

// Кладем все задачи списка в массив
   var tasks = Tasks.Tasks.list(taskListId);    
    for (var i = 0; i < tasks.items.length; i++)
     {
         var task = tasks.items[i];
         Logger.log(i. ". ",%s, task.title, task.id);
       }

Работа с календарем

var timeZone = CalendarApp.getTimeZone();
var description = Utilities.formatString( '%s from %s to %s', "заголовок события", dateString_( "дата начала события", "часовой пояс" ), dateString_("дата конца события", "часовой пояс" ));
CalendarApp.createEventFromDescription(description);

Формы обмена скриптами

События

Работа с базами данных

var conn = Jdbc.getConnection(dbUrl, user, userPwd);
var start = new Date();
var stmt = conn.createStatement();
stmt.setMaxRows(1000);
var results = stmt.executeQuery('SELECT * FROM entries');
var numCols = results.getMetaData().getColumnCount();
while (results.next()) {
var rowString = '';
for (var col = 0; col < numCols; col++)
{
    rowString += results.getString(col + 1) + '\t';
}
    Logger.log(rowString)
}
results.close();
stmt.close();

• первый — хранить данные в виде таблиц на Google Drive;
• второй — разместить базу на стороннем сервере, на нем же разместить {php}{hode.js}{python}{и т. д.} скрипт, который будет выполнять к ней запрос и возвращать ответ в формате JSON или XML, а его, в свою очередь, подвергать парсингу внутри GS. Подробности о Google Cloud SQL

Приложения, с которыми может взаимодействовать Google Apps Script

• Google Mail — почтовый клиент. Наиболее интересна в нем возможность отправлять письма людям, адреса которых неизвестны. Для этого надо включить настройку «Отправлять письма пользователям Google+» и ввести имя и фамилию получателя в поле «Кому».
• Google Calendar — органайзер. Самое удобное в нем — возможность отправки SMS-уведомлений о событиях на номера российских операторов.
• Google Contacts — приложение для хранения контактов. Самый цимес его в том, что если ты случайно синхронизируешь свой список контактов с новым смартфоном и все имена сотрутся, то сможешь попросить у Google резервную копию предыдущей версии, которая навечно сохранена в его архивах.
• Google Drive — облачное хранилище данных. 15 Гб, на которых также размещаются данные всех других приложений, доступны бесплатно.
• Google Maps — онлайн-карты. Жителям СНГ повезло, у них есть альтернативный инструмент для построения маршрутов и просмотра панорам улиц — Яндекс.Карты. Для жителей большинства других территорий альтернатив нет. Google Maps — единственная всемирная картографическая система, позволяющая искать населенные пункты, вводя названия на языке государства, в котором они находятся. Допустим, не Kotlas, а Котлас, не Vagharshapat, а Վաղարշապատ.
• Google Docs — онлайн-редактор офисных документов. Во время написания статьи этот сервис совершил мега-прорыв — появилась возможность редактировать документы, созданные в Microsoft Office. Это произошло после интеграции сервиса с функционалом приложения Quickoffice. Ради интереса попробовала отредактировать в Google Docs пояснительную записку к диплому (как пример документа с простейшим форматированием). Преобразование docx в гугл-формат пришлось ждать около минуты, и внешний вид текста явно отличался от оригинала.
• Google Forms позволяет создавать формы для сбора различных данных (онлайн-опрос, страницу регистрации на событие, обратную связь для сайта и прочее), которые можно привязать к таблицам в различных форматах (HTML, CVS, TXT, PDF, RSS, XLS, ODF). Собранные данные хранятся на Google Drive.
• Google Sites — бесплатный хостинг (100 Мб) с предельно ограниченным функционалом и собственной wiki-разметкой. Полнофункциональный HTML, а также CSS и JS недоступны.

Advanced Google Services

• Google AdSense — сервис для работы с контекстными рекламными объявлениями.
• Google Analytics — осуществляет анализ посещаемости веб-сайтов и мобильных приложений.
• Google BigQuery — позволяет производить различные манипуляции (запись, чтение, перемещение и так далее) над большими объемами данных, а также анализировать их.
• Google Fusion Tables — экспериментальный сервис, позволяющий размещать данные в облаке, отправлять к ним запросы и получать результаты выполнения в формате JSON и CSV. Из которых, в свою очередь, можно формировать электронные таблицы, карты, графики и другие виды визуального представления данных.
• Google Domains — сервис для регистрации доменов (новый проект, открылся в конце июня 2014 года).
• Google Mirror — API для взаимодействия с Google Glass.
• Google Prediction — сервис для анализа данных (основанный на технологии машинного обучения). Позволяет внедрять в приложения следующие фичи: классификатор документов и писем, расчет churn rate (показатель оттока пользователей), детектор спама, оптимизатор маршрутизации сообщений и множество других интересных вещей, достойных отдельной статьи.
• Google Tasks — встроенный в Gmail сервис для составления списков дел.
• Google URL Shortener — любимый нашим журналом сервис для сокращения длинных ссылок.
• YouTube Analytics — сервис для анализа статистики просмотров видео на YotTube. Примечателен возможностью узнать демографические и географические характеристики пользователей, смотрящих определенный видеоролик. Ведь интересно выложить очередную копию клипа на песню «До свидания, кореша» и проанализировать, какого пола, возраста и места жительства ее слушатели. Подробности