🇺🇦Скрипти та API Google Ads… on Telegram: “💾 PropertiesService у Google Ads Scripts

💾 PropertiesService у Google Ads Scripts — пам'ять для ваших скриптів

Мало хто знає, але скрипти Google Ads вміють зберігати дані між запусками — без Google Таблиць і зовнішніх баз. Для цього є PropertiesService, звичне сховище "ключ–значення" з Apps Script.

Навіщо це потрібно:
✅ пам'ятати дату/час останнього запуску
✅ зберігати ID кампаній чи пошукових запитів, які скрипт уже обробив (без дублювання)
✅ лічильники запусків і статуси
✅ тримати налаштування скрипта окремо від коду

Приклад:


function main() {
  const props = PropertiesService.getScriptProperties();

  // скільки разів запускався скрипт
  const runs = Number(props.getProperty('RUN_COUNT') || 0) + 1;
  props.setProperty('RUN_COUNT', String(runs));
  props.setProperty('LAST_RUN', new Date().toISOString());

  console.log('Запуск №' + runs);
}

Запустіть двічі — і побачите, що лічильник зберігся. 🔁

Складніші дані (об'єкти, масиви) зберігаємо через JSON:


props.setProperty('CONFIG', JSON.stringify({ budget: 500, regions: ['UA', 'PL'] }));
const config = JSON.parse(props.getProperty('CONFIG'));

⚠️ Нюанси:
— в Ads Scripts доступний лише getScriptProperties() (getUserProperties і getDocumentProperties — це вже тільки Apps Script);
— усі значення зберігаються як рядки, тому числа й об'єкти конвертуємо самі;
— є ліміти: ~9 КБ на значення і ~500 КБ на все сховище. Для великих обсягів — Таблиці або BigQuery.

Документація: https://developers.google.com/apps-script/guides/properties