Google Apps Script: Как создать пустой массив?

/**
 * Пример объявления и инициализации массива строк.
 */
function declareAndInitializeArray(): void {
  // Объявляем массив строк с начальными значениями
  const campaignNames: string[] = ["Поиск - Бренд", "КМС - Ремаркетинг", "Поиск - Общие запросы"];
  Logger.log(campaignNames);
  Logger.log(typeof campaignNames); // object
  Logger.log(Array.isArray(campaignNames)); // true
}

/**
 * Создание пустого массива с использованием литерала.
 */
function createEmptyArrayLiteral(): void {
  // Создаем пустой массив для хранения ID конверсий
  const conversionIds: number[] = [];
  Logger.log(conversionIds);      // Вывод: []
  Logger.log(conversionIds.length); // Вывод: 0
}

/**
 * Создание пустого массива с использованием конструктора Array().
 */
function createEmptyArrayConstructor(): void {
  // Создаем пустой массив для хранения объектов отчетов
  const reportObjects: object[] = new Array();
  Logger.log(reportObjects);      // Вывод: []
  Logger.log(reportObjects.length); // Вывод: 0
}

/**
 * Добавление элементов в массив с помощью push().
 */
function addElementsWithPush(): void {
  const keywords: string[] = [];
  Logger.log(`Начальная длина: ${keywords.length}`); // 0

  // Добавляем элементы
  let newLength = keywords.push("google apps script tutorial");
  Logger.log(`Добавлен элемент: ${keywords[0]}, Новая длина: ${newLength}`); // 1

  newLength = keywords.push("apps script automation", "gas examples");
  Logger.log(`Массив после добавления: ${keywords}`);
  Logger.log(`Новая длина: ${newLength}`); // 3
}

/**
 * Добавление элементов в массив по индексу.
 */
function addElementsByIndex(): void {
  const campaignData: object[] = [];

  // Добавляем первый элемент (индекс 0)
  campaignData[0] = { id: "C123", name: "Search Campaign", budget: 50 };
  Logger.log(`Массив после индекса 0: ${JSON.stringify(campaignData)}`);
  Logger.log(`Длина: ${campaignData.length}`); // 1

  // Добавляем следующий элемент (индекс 1)
  campaignData[1] = { id: "C456", name: "Display Campaign", budget: 30 };
  Logger.log(`Массив после индекса 1: ${JSON.stringify(campaignData)}`);
  Logger.log(`Длина: ${campaignData.length}`); // 2

  // Осторожно: Создание 'дыр' в массиве
  campaignData[5] = { id: "C789", name: "Video Campaign", budget: 70 };
  Logger.log(`Массив после индекса 5: ${JSON.stringify(campaignData)}`);
  Logger.log(`Длина: ${campaignData.length}`); // 6 (индексы 2, 3, 4 будут )
  Logger.log(campaignData[3]); // undefined
}

/**
 * Добавление различных типов данных в массив.
 */
function addMixedDataTypes(): void {
  const mixedData: any[] = [];

  mixedData.push("Строковый элемент"); // string
  mixedData.push(123.45);              // number
  mixedData.push(true);                // boolean
  mixedData.push(null);                // null
  mixedData.push({ key: "value" });     // object
  mixedData.push(new Date());          // Date object

  Logger.log(`Смешанный массив: ${JSON.stringify(mixedData)}`);
  Logger.log(`Длина: ${mixedData.length}`); // 6
}

/**
 * Пример ошибки при доступе к элементу пустого массива.
 */
function accessEmptyArrayError(): void {
  const empty: string[] = [];
  try {
    const firstElement: string = empty[0];
    Logger.log(firstElement); // Не выполнится, т.к. firstElement = undefined
    // Ошибка возникнет при попытке использовать метод строки на undefined
    Logger.log(firstElement.toUpperCase()); 
  } catch (e) {
    Logger.log(`Ошибка: ${e}`); // TypeError: Cannot read property 'toUpperCase' of undefined
  }
  
  // Правильно: проверять длину перед доступом
  if (empty.length > 0) {
     const firstElement: string = empty[0];
     // ... работа с элементом
  } else {
     Logger.log("Массив пуст, доступ к элементу невозможен.");
  }
}

/**
 * Собирает email'ы из указанного столбца таблицы Google Sheets.
 * @param {string} sheetName Имя листа.
 * @param {number} emailColumn Номер столбца с email (начиная с 1).
 * @return {string[]} Массив email-адресов.
 */
function getEmailsFromSheet(sheetName: string = "Лист1", emailColumn: number = 3): string[] {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName(sheetName);
  if (!sheet) {
    Logger.log(`Лист с именем '${sheetName}' не найден.`);
    return []; // Возвращаем пустой массив, если лист не найден
  }

  const dataRange = sheet.getDataRange();
  const values = dataRange.getValues();

  const emails: string[] = []; // Создаем пустой массив для результатов

  // Пропускаем заголовок (i=1)
  for (let i = 1; i < values.length; i++) {
    const row = values[i];
    const email = row[emailColumn - 1]; // Индексация в массиве с 0

    // Простая проверка на валидность email и непустое значение
    if (email && typeof email === 'string' && email.includes('@')) {
      emails.push(email.trim());
    }
  }

  Logger.log(`Найдено ${emails.length} email адресов.`);
  return emails;
}

/**
 * Фильтрует массив объектов кампаний по бюджету.
 * @param {{id: string, name: string, budget: number}[]} campaigns Массив объектов кампаний.
 * @param {number} minBudget Минимальный бюджет.
 * @return {{id: string, name: string, budget: number}[]} Отфильтрованный массив кампаний.
 */
function filterCampaignsByBudget(campaigns: {id: string, name: string, budget: number}[], minBudget: number): {id: string, name: string, budget: number}[] {
  
  const filteredCampaigns: {id: string, name: string, budget: number}[] = []; // Пустой массив для результатов фильтрации

  for (const campaign of campaigns) {
    if (campaign.budget >= minBudget) {
      filteredCampaigns.push(campaign);
    }
  }

  // Альтернатива с использованием Array.prototype.filter
  // const filteredCampaigns = campaigns.filter(campaign => campaign.budget >= minBudget);

  Logger.log(`Кампаний с бюджетом >= ${minBudget}: ${filteredCampaigns.length}`);
  return filteredCampaigns;
}

/** Пример использования функции фильтрации */
function testCampaignFilter(): void {
   const allCampaigns = [
     { id: "C1", name: "Search Low Budget", budget: 20 },
     { id: "C2", name: "Search High Budget", budget: 150 },
     { id: "C3", name: "Display Medium Budget", budget: 75 }
   ];
   const highBudgetCampaigns = filterCampaignsByBudget(allCampaigns, 100);
   Logger.log(JSON.stringify(highBudgetCampaigns)); 
}

/**
 * Извлекает UTM-метки из массива URL-адресов.
 * @param {string[]} urls Массив URL.
 * @return {{source: string | null, medium: string | null, campaign: string | null}[]} Массив объектов с UTM-метками.
 */
function extractUtmTags(urls: string[]): {source: string | null, medium: string | null, campaign: string | null}[] {
  
  const utmResults: {source: string | null, medium: string | null, campaign: string | null}[] = []; // Пустой массив для хранения результатов

  for (const urlString of urls) {
    try {
      const url = new URL(urlString); // Используем встроенный объект URL для парсинга
      const params = url.searchParams;
      
      const utm = {
        source: params.get('utm_source'),
        medium: params.get('utm_medium'),
        campaign: params.get('utm_campaign')
      };
      utmResults.push(utm);
    } catch (e) {
      Logger.log(`Не удалось распарсить URL: ${urlString}. Ошибка: ${e}`);
      // Можно добавить объект с null значениями или пропустить
      utmResults.push({ source: null, medium: null, campaign: null }); 
    }
  }
  return utmResults;
}

/** Пример использования */
function testUtmExtraction(): void {
  const landingPages = [
    "https://example.com/?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale",
    "https://example.com/about",
    "https://example.com/?utm_source=facebook&utm_medium=cpm",
    "invalid-url"
  ];
  const extractedTags = extractUtmTags(landingPages);
  Logger.log(JSON.stringify(extractedTags, null, 2));
}