Веб-функции

Функции импорта внешних данных: из другого файла-таблицы (IMPORTRANGE) и с веб-страниц по URL (IMPORTDATA, IMPORTHTML, IMPORTXML). Данные загружаются асинхронно: ячейка показывает индикатор загрузки и заполняется после получения.

IMPORTRANGE

IMPORTRANGE(идентификатор_файла; диапазон)

Импортирует диапазон ячеек из другого файла-таблицы.

• идентификатор_файла — идентификатор файла-источника из адресной строки (часть URL после /files/).
• диапазон — диапазон в нотации A1, при необходимости с именем листа ("Лист1!A1:B10" или "A1").

Импортировать можно только файлы, к которым у вас есть доступ — права проверяются так же, как при открытии файла.

Данные загружаются асинхронно: при первом обращении ячейка показывает индикатор загрузки, а после получения заполняется автоматически. Импорт обновляется почти в реальном времени — при изменении файла-источника значения подтягиваются заново; пока грузятся свежие данные, ячейка продолжает показывать предыдущие.

Импортируется отображаемое значение ячеек источника, поэтому ссылаться можно и на ячейки с формулами или Python — вернётся их вычисленный результат.

Диапазон ограничен 100 000 ячейками.

Аргументы

Аргумент	Тип	Обязательный
идентификатор_файла	Любое	Да
диапазон	Диапазон	Да

Примеры

Формула	Результат
IMPORTRANGE("1aBcD2eFgHiJ"; "Лист1!A1:B10")	{}

IMPORTDATA

IMPORTDATA(адрес_ссылки)

Импортирует данные в формате CSV или TSV с указанного URL.

• адрес_ссылки — веб-адрес файла с данными, включая протокол http:// или https://. Можно указать строкой или ссылкой на ячейку с адресом.

Разделитель (запятая, точка с запятой, табуляция и т. п.) определяется автоматически. Значения раскладываются по ячейкам начиная с той, где записана формула; типы (числа, даты, текст) выводятся автоматически.

Данные загружаются асинхронно через сервер (браузер не может обращаться к произвольным адресам напрямую): при первом обращении ячейка показывает индикатор загрузки, а после получения заполняется автоматически. Импорт периодически обновляется; пока грузятся свежие данные, ячейка продолжает показывать предыдущие.

Из соображений безопасности доступны только публичные адреса — обращения к внутренним и локальным адресам сети блокируются. Размер загружаемых данных ограничен 10 МБ.

Аргументы

Аргумент	Тип	Обязательный
адрес_ссылки	Ссылка	Да

Примеры

Формула	Результат
IMPORTDATA("https://raw.githubusercontent.com/hflabs/city/refs/heads/master/city.csv")	{}

IMPORTHTML

IMPORTHTML(адрес_ссылки; тип_элемента; [номер])

Импортирует таблицу или список с HTML-страницы по указанному URL.

• адрес_ссылки — адрес страницы, включая протокол http:// или https://.
• тип_элемента — "table" для таблицы или "list" для списка (<ul>/<ol>).
• номер — порядковый номер (с 1) нужной таблицы или списка на странице. Необязательный, по умолчанию 1.

Для таблицы каждая строка <tr> раскладывается по строкам листа, а ячейки <td>/<th> — по столбцам; для списка каждый пункт <li> попадает в отдельную строку одного столбца. Вложенные таблицы и списки не считаются отдельными.

Данные загружаются асинхронно через сервер (браузер не может обращаться к произвольным адресам напрямую): при первом обращении ячейка показывает индикатор загрузки, а после получения заполняется автоматически и периодически обновляется. Доступны только публичные адреса; размер ограничен 10 МБ.

Аргументы

Аргумент	Тип	Обязательный
адрес_ссылки	Ссылка	Да
тип_элемента	Число	Да
номер	Число	Нет

Примеры

Формула	Результат
IMPORTHTML("https://ru.wikipedia.org/wiki/Список_стран_по_населению"; "table"; 1)	{}
IMPORTHTML("https://ru.wikipedia.org/wiki/Список_стран_по_населению"; "list"; 1)	{}

IMPORTXML

IMPORTXML(адрес_ссылки; запрос_xpath)

Импортирует данные из XML или HTML по XPath-выражению. Источник сначала разбирается как XML, а при невалидном XML — как HTML-страница.

• адрес_ссылки — адрес документа или страницы, включая протокол http:// или https://.
• запрос_xpath — XPath-выражение. Каждый совпавший узел попадает в отдельную строку одного столбца.

Поддерживается распространённое подмножество XPath: путь от корня (/root/elem), поиск среди всех потомков (//elem), вложенный поиск (//table//td), индекс (//elem[2]), любой элемент (*), извлечение атрибута (//a/@href) и текста (//elem/text()), а также предикаты по атрибутам — наличие (//a[@href]), равенство (//div[@class='price']) и вхождение (//div[contains(@class,'price')]). Имена сопоставляются без учёта пространств имён.

Данные загружаются асинхронно через сервер (браузер не может обращаться к произвольным адресам напрямую): при первом обращении ячейка показывает индикатор загрузки, а после получения заполняется автоматически и периодически обновляется. Доступны только публичные адреса; размер ограничен 10 МБ.

Аргументы

Аргумент	Тип	Обязательный
адрес_ссылки	Ссылка	Да
запрос_xpath	Текст	Да

Примеры

Формула	Результат
IMPORTXML("https://ru.wikipedia.org/wiki/Высадка_на_Луну"; "//a/@href")	{}
IMPORTXML("https://ru.wikipedia.org/wiki/Высадка_на_Луну"; "//h2")	{}