Как проверить текст в Google Apps Script на наличие определенных слов?

Обзор Google Apps Script и его возможностей для обработки текста

Google Apps Script (GAS) – это облачная платформа, позволяющая автоматизировать задачи и расширять функциональность Google Workspace (Sheets, Docs, Forms и т.д.). Одним из распространенных применений GAS является обработка текста: извлечение данных, форматирование, генерация отчетов и, конечно, поиск определенных слов или фраз.

Постановка задачи: зачем проверять текст на определенные слова?

Необходимость проверки текста на наличие ключевых слов возникает во многих сценариях:

Интернет-маркетинг и SEO: Анализ контента веб-страниц или рекламных объявлений на соответствие заданным ключевым словам.

Анализ данных: Поиск определенных терминов в больших объемах текстовых данных (например, в отзывах клиентов) для выявления тенденций или проблем.

Автоматизация документов: Автоматическое заполнение шаблонов документов на основе наличия определенных слов в исходном тексте.

Модерация контента: Обнаружение нежелательного контента (например, нецензурной лексики) в сообщениях пользователей.

Необходимые инструменты и предварительная настройка

Для работы с Google Apps Script вам понадобится:

Аккаунт Google.

Доступ к Google Sheets, Docs или другому приложению Google Workspace, где будет использоваться скрипт.

Редактор Google Apps Script (открывается через "Инструменты" > "Редактор скриптов" в Google Sheets/Docs).

Основные методы поиска слов в тексте

Использование метода `indexOf()` для простого поиска

Метод indexOf() является самым простым способом проверить, содержит ли строка определенное слово. Он возвращает индекс первого вхождения подстроки в строку, или -1, если подстрока не найдена.

Применение регулярных выражений (RegExp) для гибкого поиска

Регулярные выражения предоставляют гораздо более мощный и гибкий инструмент для поиска. С их помощью можно выполнять сложные поисковые запросы, учитывая регистр, словоформы и другие параметры.

Преимущества и недостатки каждого метода

indexOf(): Прост в использовании, но не поддерживает сложные поисковые запросы и чувствителен к регистру.

RegExp: Мощный и гибкий, но требует знания синтаксиса регулярных выражений и может быть менее производительным для простых задач.

Практическая реализация проверки текста в Google Apps Script

Написание функции для проверки наличия одного ключевого слова

/**
 * Проверяет, содержит ли текст заданное ключевое слово.
 *
 * @param {string} text Исходный текст для проверки.
 * @param {string} keyword Ключевое слово для поиска.
 * @param {boolean} ignoreCase (optional) Игнорировать регистр при поиске. По умолчанию: true.
 * @return {boolean} True, если ключевое слово найдено, иначе false.
 */
function containsKeyword(text: string, keyword: string, ignoreCase: boolean = true): boolean {
  if (ignoreCase) {
    text = text.toLowerCase();
    keyword = keyword.toLowerCase();
  }
  return text.indexOf(keyword) !== -1;
}

// Пример использования
function testContainsKeyword() {
  let text = "This is a sample text with the keyword example.";
  let keyword = "example";
  let result = containsKeyword(text, keyword);
  Logger.log(result); // Output: true

  result = containsKeyword(text, "Example", false); // Case-sensitive
  Logger.log(result); // Output: false
}

Разработка функции для поиска нескольких ключевых слов

/**
 * Проверяет, содержит ли текст хотя бы одно из заданных ключевых слов.
 *
 * @param {string} text Исходный текст для проверки.
 * @param {string[]} keywords Массив ключевых слов для поиска.
 * @param {boolean} ignoreCase (optional) Игнорировать регистр при поиске. По умолчанию: true.
 * @return {boolean} True, если хотя бы одно ключевое слово найдено, иначе false.
 */
function containsAnyKeyword(text: string, keywords: string[], ignoreCase: boolean = true): boolean {
  for (let i = 0; i < keywords.length; i++) {
    if (containsKeyword(text, keywords[i], ignoreCase)) {
      return true;
    }
  }
  return false;
}

// Пример использования
function testContainsAnyKeyword() {
  let text = "This is a sample text with keywords.";
  let keywords = ["sample", "another", "keywords"];
  let result = containsAnyKeyword(text, keywords);
  Logger.log(result); // Output: true
}

Обработка регистра слов при поиске

Как видно из примеров выше, обработка регистра реализована с использованием toLowerCase(). Параметр ignoreCase позволяет контролировать, будет ли поиск чувствительным к регистру.

Примеры использования функций в различных сценариях (Google Sheets, Docs)

Google Sheets:

function onEdit(e) {
  let sheet = e.range.getSheet();
  let row = e.range.getRow();
  let column = e.range.getColumn();
  
  // Проверяем текст в столбце A (первый столбец)
  if (column === 1) {
    let text = sheet.getRange(row, column).getValue();
    let keywords = ["важно", "срочно"];
    if (containsAnyKeyword(text, keywords)) {
      // Если текст содержит ключевые слова, выделяем строку красным цветом
      sheet.getRange(row, 1, 1, sheet.getLastColumn()).setBackground("red");
    }
  }
}

Google Docs:

function findKeywordsInDocument() {
  let doc = DocumentApp.getActiveDocument();
  let body = doc.getBody();
  let text = body.getText();
  let keywords = ["Google", "Apps Script"];

  if (containsAnyKeyword(text, keywords)) {
    Logger.log("Документ содержит ключевые слова.");
  }
}

Оптимизация и улучшение кода

Повышение производительности скрипта при работе с большими объемами текста

Для очень больших объемов текста (например, при обработке сотен тысяч строк в Google Sheets) использование indexOf() может быть недостаточно быстрым. В таких случаях рассмотрите возможность использования специализированных библиотек для обработки текста или оптимизированных алгоритмов поиска.

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

Обработка ошибок и исключений

Всегда предусматривайте обработку ошибок в вашем коде. Например, проверяйте, что входные данные (текст и ключевые слова) не являются null или undefined.

Рекомендации по стилю кода и документированию

Используйте понятные имена переменных и функций.

Добавляйте комментарии, объясняющие логику вашего кода.

Следуйте стандартам кодирования JavaScript (например, используйте линтеры для автоматической проверки стиля).

Заключение

Краткое резюме основных моментов

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

Дополнительные ресурсы и полезные ссылки

Документация Google Apps Script

Справочник по регулярным выражениям

Возможные направления для дальнейшего изучения

Более глубокое изучение регулярных выражений для решения сложных задач поиска.

Использование внешних библиотек для обработки текста (например, для стемминга и лемматизации).

Разработка собственных функций для автоматической классификации текста на основе ключевых слов.