SEO-ракета: Як автоматизувати перевірку позицій через Google Apps Script

1. вставити його в редактор Apps Script;
2. замінити значення SITE_URL на свій ресурс із Search Console;
3. запустити функцію updateSeoRocket();
4. дозволити доступи при першому запуску.

    const SITE_URL = 'https://example.com/';
    const QUERY_SHEET = 'GSC Queries';
    const TREND_SHEET = 'GSC Trend';
    const DASHBOARD_SHEET = 'GSC Dashboard';
    const DAYS_BACK = 30;
    const QUERY_LIMIT = 100;

    function updateSeoRocket() {
      const ss = SpreadsheetApp.getActiveSpreadsheet();
      const querySheet = getOrCreateSheet_(ss, QUERY_SHEET);
      const trendSheet = getOrCreateSheet_(ss, TREND_SHEET);

      writeQueryReport_(querySheet);
      writeTrendReport_(trendSheet);
      buildTrendChart_(ss, trendSheet);
    }

    function writeQueryReport_(sheet) {
      sheet.clear();

      const range = getDateRange_(DAYS_BACK);
      const request = {
        startDate: range.startDate,
        endDate: range.endDate,
        dimensions: ['query'],
        rowLimit: QUERY_LIMIT,
        dataState: 'final'
      };

      const response = SearchConsole.Searchanalytics.query(request, SITE_URL);
      const rows = response.rows || [];

      const values = [
        ['Запит', 'Кліки', 'Покази', 'CTR', 'Середня позиція', 'Дата оновлення']
      ];

      rows.forEach(row => {
        const query = row.keys && row.keys[0] ? row.keys[0] : '';
        const clicks = row.clicks || 0;
        const impressions = row.impressions || 0;
        const ctr = row.ctr || 0;
        const position = row.position || 0;

        values.push([
          query,
          clicks,
          impressions,
          ctr,
          position,
          new Date()
        ]);
      });

      if (values.length === 1) {
        values.push(['Немає даних за вибраний період', '', '', '', '', new Date()]);
      }

      sheet.getRange(1, 1, values.length, values[0].length).setValues(values);
      sheet.getRange(2, 4, Math.max(values.length - 1, 1), 1).setNumberFormat('0.00%');
      sheet.getRange(2, 5, Math.max(values.length - 1, 1), 1).setNumberFormat('0.00');
      sheet.autoResizeColumns(1, values[0].length);
      sheet.setFrozenRows(1);
    }

    function writeTrendReport_(sheet) {
      sheet.clear();

      const range = getDateRange_(DAYS_BACK);
      const request = {
        startDate: range.startDate,
        endDate: range.endDate,
        dimensions: ['date'],
        rowLimit: DAYS_BACK,
        dataState: 'final'
      };

      const response = SearchConsole.Searchanalytics.query(request, SITE_URL);
      const rows = response.rows || [];

      const values = [
        ['Дата', 'Кліки', 'Покази', 'CTR', 'Середня позиція']
      ];

      rows.forEach(row => {
        const date = row.keys && row.keys[0] ? row.keys[0] : '';
        values.push([
          date,
          row.clicks || 0,
          row.impressions || 0,
          row.ctr || 0,
          row.position || 0
        ]);
      });

      if (values.length === 1) {
        values.push(['Немає даних', '', '', '', '']);
      }

      sheet.getRange(1, 1, values.length, values[0].length).setValues(values);
      sheet.getRange(2, 4, Math.max(values.length - 1, 1), 1).setNumberFormat('0.00%');
      sheet.getRange(2, 5, Math.max(values.length - 1, 1), 1).setNumberFormat('0.00');
      sheet.autoResizeColumns(1, values[0].length);
      sheet.setFrozenRows(1);
    }

    function buildTrendChart_(ss, trendSheet) {
      let dashboard = ss.getSheetByName(DASHBOARD_SHEET);
      if (!dashboard) {
        dashboard = ss.insertSheet(DASHBOARD_SHEET);
      }

      dashboard.clear();
      dashboard.getRange('A1').setValue('Динаміка середньої позиції за останні 30 днів');

      const lastRow = trendSheet.getLastRow();
      if (lastRow < 2) return;

      const chart = dashboard.newChart()
        .setChartType(Charts.ChartType.LINE)
        .addRange(trendSheet.getRange(1, 1, lastRow, 1))
        .addRange(trendSheet.getRange(1, 5, lastRow, 1))
        .setPosition(3, 1, 0, 0)
        .setOption('title', 'Середня позиція по днях')
        .setOption('legend', { position: 'bottom' })
        .setOption('curveType', 'function')
        .setOption('hAxis', { title: 'Дата' })
        .setOption('vAxis', { title: 'Позиція', direction: -1 })
        .build();

      dashboard.insertChart(chart);
    }

    function createWeeklyTrigger() {
      deleteTriggers_('updateSeoRocket');

      ScriptApp.newTrigger('updateSeoRocket')
        .timeBased()
        .everyWeeks(1)
        .onWeekDay(ScriptApp.WeekDay.MONDAY)
        .atHour(9)
        .create();
    }

    function createMonthlyTrigger() {
      deleteTriggers_('updateSeoRocket');

      ScriptApp.newTrigger('updateSeoRocket')
        .timeBased()
        .onMonthDay(1)
        .atHour(9)
        .create();
    }

    function deleteTriggers_(functionName) {
      ScriptApp.getProjectTriggers().forEach(trigger => {
        if (trigger.getHandlerFunction() === functionName) {
          ScriptApp.deleteTrigger(trigger);
        }
      });
    }

    function getDateRange_(daysBack) {
      const tz = Session.getScriptTimeZone();
      const end = new Date();
      const start = new Date();
      start.setDate(end.getDate() - daysBack);

      return {
        startDate: Utilities.formatDate(start, tz, 'yyyy-MM-dd'),
        endDate: Utilities.formatDate(end, tz, 'yyyy-MM-dd')
      };
    }

    function getOrCreateSheet_(ss, name) {
      let sheet = ss.getSheetByName(name);
      if (!sheet) {
        sheet = ss.insertSheet(name);
      }
      return sheet;
    }