GrayAPI: что это и как подключить

GrayAPI — внешний сервис, через который avBids ставит ставки по городам и снимает объявления с публикации. Что он даёт, как подключить и какие есть ограничения.

GrayAPI — внешний сервис, через который avBids выполняет действия, недоступные в стандартном API Авито: ставки по отдельным городам и снятие объявления с публикации. Подключается один раз на кабинет — токеном на странице «Безопасность».

Что работает через GrayAPI

Модуль

Что даёт GrayAPI

Гео-биддер

Весь модуль: ставки и лимиты по городам

Ручной биддер

Ставки по локациям, режим «Снять с публикации» вне расписания

Биддер по поиску

Ставки по локациям в ссылке и снятие с публикации в нерабочее время и по лимитам

Биддер по метрикам

Режим «Снять с публикации» вне расписания

Без GrayAPI все остальные функции работают как обычно.

Как подключить

  1. Получите токен GrayAPI. Где и на каких условиях его выдают — уточните в поддержке @avBidsSupport_bot.

  2. Откройте «Безопасность» → поле «Токен GrayAPI» → вставьте токен и сохраните.

  3. Проверьте, что аккаунт Авито найден в GrayAPI: в гео-биддере у аккаунта не должно быть предупреждения, в ставках по локациям — плашки «Нужен подключённый GrayAPI».

Частые ошибки

Сообщение

Что сделать

У владельца аккаунта не задан токен GrayApi

Введите токен на странице «Безопасность»

У аккаунта не указан Avito user id

Обновите данные аккаунта или переподключите его в разделе «Аккаунты Авито»

Аккаунт не найден в GrayAPI / аккаунт не готов

Проверьте, что этот аккаунт Авито подключён в GrayAPI; в гео-биддере нажмите «Обновить статус GrayAPI»

Режим локаций не применяется

GrayAPI недоступен — ссылка временно идёт единой ставкой

Важно знать

  • Токен общий для кабинета: он действует для всех аккаунтов Авито владельца.

  • Изменения через GrayAPI применяются пачками по 25 объявлений с паузой, поэтому не мгновенно.

  • Если запрос к GrayAPI не прошёл, сервис не переключает объявление на единую ставку, а повторяет применение позже, чтобы не затереть набор городов.

  • При удалении токена гео-биддер останавливается, а ставки по локациям и снятие с публикации становятся недоступны.

Инструкция помогла?

Помощник

Задайте вопрос по документации. Вопросы без ответа используются для улучшения помощи.

Ищу ответ…

Подготовить обращение

Открыть контакт
Отправьте подготовленный текст самостоятельно в выбранном канале.