Google Sheets
Поиск прямо в таблице: формула, которая выводит сайты с заданным фрагментом кода в исходном коде страниц, и меню, которое выгружает весь запрос на новый лист. Копируется бесплатно, работает с вашим токеном API.
=PUBLICWWW(A1) websites whose page source contains the query in A1 =PUBLICWWW(A1, 50, "url,rank") 50 rows, only the url and rank columns =PUBLICWWW_COUNT(A1) how many websites match
Настройка
- Откройте таблицу и выберите Расширения > Apps Script.
-
Замените содержимое
Code.gsфайлом Code.gs из репозитория и сохраните. - Перезагрузите таблицу. Появится меню PublicWWW; выберите в нём Set API token и вставьте токен со страницы профиля. Для API нужен платный тариф.
-
Google один раз попросит разрешить работу скрипта: он читает и изменяет только
эту таблицу и подключается к
api.publicwww.com.
Токен хранится в свойствах скрипта, поэтому его может прочитать любой, кто может редактировать скрипт этой таблицы. Давайте доступ на редактирование с учётом этого или выпустите для таблицы отдельный токен, который можно удалить на странице профиля.
Как писать запрос
Запрос такой же, как в строке поиска, - см. синтаксис
запросов. Кавычки важны: "angular.min.js" в кавычках - это именно
такая строка, а без них - несколько слов. Внутри формулы кавычка пишется дважды,
=PUBLICWWW("""angular.min.js"""), поэтому проще ввести запрос вместе с
кавычками в ячейку и сослаться на неё: =PUBLICWWW(A1).
Функции
-
PUBLICWWW(query, [rows], [columns], [header])- по одному сайту на строку, самые популярные первыми.rows- по умолчанию 10, в формуле до 1000.columns- любые изdomain,url,rankчерез запятую; по умолчанию все три.header-TRUEвыводит названия колонок в первой строке.rankпуст у сайта без места в рейтинге популярности; если ничего не найдено, ячейка пустая. -
PUBLICWWW_COUNT(query)- число подходящих сайтов.
Формула выполняет поиск, когда её вводят или когда меняются её аргументы, а ответ хранится шесть часов, так что повторное открытие таблицы не тратит поиски снова. Каждая новая формула - один поиск из суточного лимита тарифа.
Выгрузка всего запроса
PublicWWW > Export a query to a new sheet записывает на новый лист все
строки выдачи по запросу, которые открывает ваш тариф, а итоговые числа - в
примечание к первой ячейке. Очень большая выгрузка может упереться в
ограничение Google - шесть минут на один запуск скрипта; для списков в сотни
тысяч строк обращайтесь напрямую к API:
format=csv открывается в любой программе для таблиц.
Если в ячейке #ERROR!
Наведите курсор на ячейку, чтобы увидеть причину.
| Причина | Что делать |
|---|---|
No API token yet | PublicWWW > Set API token. |
invalid_key | Токен удалён; укажите новый. |
plan_required | Для API нужен платный тариф. |
too_many_requests | Больше 10 запросов в минуту; подождите указанное число секунд. |
quota_exceeded | Поиски на сегодня закончились; лимит сбрасывается в полночь по UTC. |
Все коды: Ошибки.
Далее Clay