База знаний → Подготовка к работе

📊 Google-таблицы и JSON-ключ

Зачем нужна таблица, как создать сервисный аккаунт Google, получить JSON-ключ и подключить всё к программе

🕒 ~5 мин чтения 🔄 Обновлено 5 августа 2026 🏷 google, таблицы, json, service account, api, ключ, вкладки

Программа берёт рабочие данные из Google-таблицы: ключевые запросы, артикулы, список прокси, аккаунты. Туда же она пишет результаты. Чтобы это работало, нужно один раз выдать программе доступ к вашим таблицам.

Настройка выглядит громоздко, но делается один раз за 10–15 минут.

Нужна ли вам таблица#

Не всегда. У поведенческого фактора есть два режима работы с данными:

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

Режим переключается в настройках модуля — блок «Режим сбора данных».

ℹ️Для большинства модулей таблица обязательна

Ручной ввод есть только у поведенческого фактора. Авторегистрация, автовход, проверка аккаунтов, автоотзывы и трекер позиций работают только через таблицу. Так что настроить её всё равно придётся.

Шаг 1. Почта Google#

Нужен обычный аккаунт Google: accounts.google.com.

💡Заведите отдельную почту под работу

Сервисный аккаунт получит доступ к таблицам этой почты. Держать рабочие данные отдельно от личной почты — правильнее и спокойнее.

Шаг 2. Создать сервисный аккаунт#

Сервисный аккаунт — это «робот», от имени которого программа будет читать таблицу.

Откройте Google Cloud Console → Credentials
Если консоль открывается впервые — выберите страну (любую, кроме стран СНГ) и поставьте обе галочки согласия
Создайте проект и дождитесь, пока он загрузится
Нажмите Create Credentials → Service account
Заполните имя (любое) и пройдите шаги мастера до конца
Откройте созданный сервисный аккаунт → вкладка Keys → Add key → Create new key → тип JSON → Create

Файл скачается автоматически. Переместите его в удобное постоянное место — например, в папку с программой. Путь к нему понадобится дальше.

🚫JSON-ключ — это пароль

Кто угодно с этим файлом получит доступ к вашим таблицам. Не выкладывайте его в чаты и не передавайте третьим лицам. Если файл утёк — удалите ключ в консоли и создайте новый.

Шаг 3. Включить два API#

Без этого программа получит отказ в доступе, даже с правильным ключом.

Откройте Google Sheets API, выберите ваш проект и нажмите ENABLE
Откройте Google Drive API, выберите тот же проект и нажмите ENABLE

⚠️Проект должен быть тот же самый

Если в консоли несколько проектов, легко включить API не там. Проверьте название проекта в верхней панели — оно должно совпадать с тем, где вы создавали сервисный аккаунт.

Шаг 4. Скопировать шаблон таблицы#

Готовый шаблон со всеми нужными вкладками: открыть шаблон.

В шаблоне: Файл → Создать копию
Копия появится на вашем Google-диске — работать нужно с ней, не с оригиналом
(необязательно) Из адресной строки копии возьмите ID таблицы — это длинный набор символов между /d/ и /edit

Например, в адресе docs.google.com/spreadsheets/d/1AbC...XyZ/edit идентификатор — выделенная часть.

Шаг 5. Открыть доступ#

В своей копии таблицы нажмите Настройки доступа (кнопка «Поделиться»)
В блоке общего доступа выберите «Все, у кого есть ссылка»
Роль — «Редактор»

⚠️Роль именно «Редактор», а не «Читатель»

Программа не только читает таблицу, но и записывает в неё результаты: отмечает обработанные строки, проставляет статусы. С правами «Читатель» модуль запустится, но упадёт при первой попытке записи.

Шаг 6. Подключить к программе#

Откройте настройки любого модуля → блок «Google Таблицы и Прокси» и заполните:

Поле	Что вписать
Google Sheet ID или ссылка	ID из шага 4 (можно вставить всю ссылку целиком)
JSON Key Path	путь к скачанному JSON-файлу — кнопка «Выбрать» откроет проводник

Настройки сохраняются автоматически, отдельной кнопки «Сохранить» нет.

Вкладки таблицы#

У каждого модуля своя вкладка. Названия задаются в настройках модуля, а по умолчанию такие:

Модуль	Поле в настройках	Вкладка по умолчанию
Поведенческий фактор	Вкладка ПФ	`ПФ1`
Прокси (общий список)	Вкладка Прокси	`п2`
Автовход	Вкладка Google Sheets	`Вход`
Проверка аккаунтов	Вкладка Google Sheets	`Чекер`
Авторегистрация	Вкладка регистраций	`Рег`
Автоотзывы	Вкладка Google Sheets	`Отзывы`
Позиция в поиске	Вкладка Google Sheets	`КТ1`

💡Названия вкладок должны совпадать точно

Программа ищет вкладку по имени, включая регистр и пробелы. Если переименовали вкладку в таблице — поменяйте название и в настройках модуля. Лишний пробел в конце имени тоже сломает поиск.

Возможные ошибки#

Что происходит	Причина	Что делать
«Доступ запрещён» при старте	Не включён Sheets API или Drive API	Пройдите шаг 3 ещё раз, проверьте проект
Программа не видит таблицу	Не открыт доступ по ссылке	Шаг 5: «Все, у кого есть ссылку» → «Редактор»
Модуль стартует, но падает при записи	Роль «Читатель» вместо «Редактор»	Поменяйте роль в настройках доступа
«Вкладка не найдена»	Имя вкладки не совпадает с настройкой	Сверьте названия символ в символ
Ошибка чтения JSON-ключа	Файл переместили или удалили	Укажите актуальный путь в поле JSON Key Path
Работало, потом перестало	Ключ сервисного аккаунта удалён в консоли	Создайте новый ключ (шаг 2, пункт 6)

ℹ️Данные читаются при каждом запуске

Программа обращается к таблице в момент старта модуля. Значит, править данные можно между запусками — перезапускать программу целиком не нужно.

Что дальше#

Таблица подключена — заполните в ней вкладку с прокси: Прокси: подбор и подключение.