💾
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
