Режимы записи (детально)
В продукте три топ-level write_mode. Политики SoftRefresh / RewriteFromLast / Dumb — это не отдельные режимы, а output_options.append_policy при write_mode=append.
Модель
Топ-level write_mode | Что делает | Nested |
|---|---|---|
replace | Полная перезапись листа результатом запуска | — |
append | Дописать / обновить хвост | append_policy: soft_refresh (default wizard), rewrite_from_last, dumb |
append_dedup | Append с дедупом по ключу (+ incremental date refresh для ads) | ключ дедупа в output options |
Append policies (только при append)
append_policy | API range | Sheet |
|---|---|---|
soft_refresh | last_sheet_date − 1 … today | refresh хвоста по дате, затем append новых |
rewrite_from_last | last_sheet_date … today | удалить строки с last date и переписать |
dumb | полный запрошенный range | слепой physical append (риск дублей) |
Подробнее: Soft refresh, Rewrite from last, Append, AppendDedup, Replace.
1. Replace
Полная перезапись выходного листа. Старые строки уходят; остаются данные последнего запуска.
- Ручные колонки справа от матрицы — теряются
- Пустой результат — лист очищается (заголовки обычно остаются)
- Совместим с расписанием
Когда: ежедневные «текущие» дашборды без истории на том же листе.
2. Append + policies
Базовый append сам по себе — дописать. Поведение задаёт policy:
soft_refresh (default в wizard)
Date-aware: берёт последнюю дату в листе, тянет API с last−1 до today, обновляет хвост по дате, новые даты дописывает. Это не key-upsert по Campaign.
rewrite_from_last
С last sheet date до today: строки с этой даты удаляются и переписываются. Не «маркер последней строки», а дата.
dumb
Полный API range + physical append. Дубли возможны. Расписание не блокируется — просто advanced/risky.
3. AppendDedup
Перед записью сверяет ключ(и) дедупа. Для Meta / Google / TikTok / FB / IG дополнительно есть incremental refresh window (~3 дня) по date field — см. AppendDedup.
Выбор
| Сценарий | Режим |
|---|---|
| Только свежий срез | replace |
| Ежедневный хвост без дублей по датам | append + soft_refresh |
| Переписать с последней даты | append + rewrite_from_last |
| Лог без заботы о дублях | append + dumb |
| Уникальные сущности по ключу | append_dedup |