# Подключить ссылку на CSV или Google Таблицу

> **Коротко.** Как подключить опубликованную Google Таблицу или любую ссылку на CSV, выбрать перезапись или добавление и включить ежедневную автозагрузку.

Адрес: https://marfor.pro/docs/data/sources/url · Раздел: Данные: от таблицы до проверенного источника › Источники данных: откуда MARFOR берёт таблицу › Подключить ссылку на CSV или Google Таблицу · Вид: Инструкция · Уровень: для начинающих · Обновлено: 2026-10-14

Если данные живут в Google Таблице или их можно скачать по ссылке, MARFOR будет забирать их сам раз в сутки. После каждой загрузки маппинг применяется заново — разметка колонок не теряется.

## Что нужно заранее {#before}

- Ссылка, по которой CSV скачивается **без входа в аккаунт**. Проверка простая: откройте её в окне инкогнито — должен скачаться файл или показаться текст с разделителями.
- Таблица по правилам: дата в каждой строке, разрезы текстом, показатели числами — [какие данные нужны](https://marfor.pro/docs/data/requirements).

**Google Таблица.** «Файл» → «Поделиться» → «Опубликовать в интернете», выберите лист и формат CSV, опубликуйте и скопируйте ссылку — она кончается на `output=csv`. Обычная ссылка из адресной строки (`…/edit`) не подойдёт.

## Шаги {#steps}

1. В проекте: «Источники данных» → «Добавить источник» → вкладка «URL».
2. «Название источника», затем вставьте ссылку в «URL файла (CSV)» и нажмите «Проверить URL». Должно появиться «N строк, M колонок».
3. «Режим импорта»:
   - «Полная перезапись» — каждое обновление заменяет данные целиком. Берите, если по ссылке лежит вся история;
   - «Добавление (Append)» — строки за даты из нового файла заменяются, за остальные даты остаются. Берите, если по ссылке только свежие дни, а история должна копиться в MARFOR. Нужна колонка даты в маппинге.
4. «Включить автозагрузку по расписанию» и «Время обновления» — по UTC: 06:00 UTC = 09:00 по Москве. «Уведомлять по email при обновлении и ошибках» включено сразу.
5. «Загрузить» → «Загружено: N строк, M колонок».
6. На карточке — «Настроить маппинг» → «Применить маппинг». Дальше каждое обновление переприменит маппинг само.

Чем перезапись отличается от добавления, на картинке и с примером, — [как обновляется источник](https://marfor.pro/docs/data/sources/refresh).

## Как понять, что получилось {#result}

Карточка с типом «CSV (URL)» и строкой «Pipeline: ежедневно (перезапись)» — или «ежедневно (append)»; если автозагрузка выключена — «выкл». После первой автозагрузки ниже появится её время и сколько строк пришло.

- Первая автозагрузка проходит через несколько минут после создания источника, дальше — раз в сутки, не раньше заданного времени.
- Обновить вручную — круговые стрелки на карточке («Обновить данные с URL»). Пока обновление идёт, второе не запустится.
- Прошлые загрузки — значок «История загрузок».
- Режим импорта, время и письма меняют в «Настройках источника и Pipeline» (значок с ползунками): [поля настроек](https://marfor.pro/docs/data/sources/settings). Саму ссылку там поменять нельзя — для другой ссылки добавьте новый источник.
- Письма: «MARFOR — Данные обновлены • …» или «MARFOR — Ошибка обновления • …».

> [!Совет]
> Удалили из Google Таблицы старые месяцы, чтобы она не разрасталась? При «Полной перезаписи» они пропадут и в MARFOR. Чтобы история копилась, а в таблице были только свежие недели, включите «Добавление».

## Если не получилось {#troubleshooting}

- **«Некорректный URL» или «Разрешены только http(s) URL».** Проверьте, что ссылка скопирована целиком и начинается с `https://`.
- **«HTTP 403», «HTTP 404», «Ошибка загрузки: HTTP …».** Ссылка закрыта или не опубликована. Откройте её в окне инкогнито: файл должен скачаться без входа.
- **«Не удалось распознать CSV. Проверьте формат данных.»** По ссылке страница, а не CSV — у Google Таблицы нужна ссылка публикации с `output=csv`.
- **«Загрузка с внутренних/приватных адресов запрещена».** Нужен адрес, открытый из интернета.
- **«Хост URL не разрешён политикой безопасности».** Загрузка с этого адреса закрыта настройками MARFOR. Напишите в поддержку: «Помощь» → «Обратная связь».
- **«Режим «Добавление» заменяет строки по датам из файла, а колонка даты не найдена…».** На маппинге у колонки с датой выберите «Временной ряд» → «Дата» и примените маппинг — или переключите источник на «Полную перезапись» в настройках. Данные при этом отказе не меняются.
- **«Источник превышает лимит вашего тарифа…».** На Free в источнике — до 10 000 строк: [ограничения на старте](https://marfor.pro/docs/account/limits).
- **Автозагрузка не срабатывает или пишет об ошибке** — [источник не обновляется](https://marfor.pro/docs/data/sources/update-failed).

## Связанные

- [Как обновляется источник: перезапись, добавление и окно перезабора](https://marfor.pro/docs/data/sources/refresh)
- [Настройки источника и автозагрузка: все поля](https://marfor.pro/docs/data/sources/settings)
- [Загрузить файл CSV или Excel](https://marfor.pro/docs/data/sources/file)
- [Письма от MARFOR: какие приходят и как их выключить](https://marfor.pro/docs/account/emails)