Перейти до вмісту
ReviewSmith

Підключення Google Business Profile

Підключіть Google-акаунт, що керує вашими локаціями, дізнайтеся, що означає схвалення API від Google, і виправте типові помилки підключення.

ReviewSmith читає ваші відгуки в Google і публікує схвалені вами відповіді через офіційні API Google Business Profile. Ви входите через Google і надаєте один дозвіл: керування профілем компанії (business.manage). Ми ніколи не бачимо вашого пароля Google.

Підключення

  1. Відкрийте https://reviewsmith.com.ua/app/integrations/google, підтвердьте, що ви власник або менеджер профілю компанії (або що власник вас уповноважив), і натисніть Підключити Google.
  2. Оберіть Google-акаунт, який є власником або менеджером ваших локацій у Business Profile.
  3. Надайте дозвіл. Ви повернетеся в ReviewSmith, де буде список акаунтів і локацій, які він бачить.
  4. Оберіть локації для відстеження. Перша синхронізація завантажить ваші відгуки (великі профілі — за кілька запусків), далі нові відгуки з'являються приблизно кожні 30 хвилин.

Відгуки й відповіді через API доступні лише для верифікованих локацій. Якщо локацію не верифіковано, спершу завершіть верифікацію в Business Profile.

Що означає «очікує схвалення Google»

Google надає доступ до API Business Profile лише після перевірки застосунку. Поки наш проєкт у Google Cloud не схвалено, Google дозволяє 0 запитів на хвилину, і сторінка інтеграції показує Підключення Google очікує схвалення. У цьому стані:

  • можна користуватися демоданими, імпортом CSV, аналітикою роботи команди, голосом бренду, шаблонами й чернетками;
  • інструменти, яким потрібен Google (синхронізація, публікація чи видалення відповідей), повертають зрозумілу помилку google_not_connected або google_not_approved;
  • щойно Google надасть квоту, синхронізація почнеться автоматично, без жодних дій із вашого боку.

Як працюють синхронізація й кеш

  • Нові й змінені відгуки завантажуються кожні 30 хвилин для кожної локації, від найновіших, і зупиняються, щойно доходять до вже відомих. Раз на тиждень відбувається повне оновлення; відгуки, яких у Google більше немає, видаляються.
  • Вміст відгуків зберігається лише як короткочасний кеш, як вимагають правила Google: кожен відгук у кеші спливає не пізніше ніж через 30 днів після отримання й видаляється щоденним завданням. Прострочений відгук ніколи не показується — його знову завантажують із Google. list_reviews також оновлює локацію з Google, якщо її дані старші за 30 хвилин.
  • Показники з get_review_stats і дашборду (середня оцінка Google, кількість відгуків, відгуки без відповіді, частка відповідей) отримуються з Google у момент запиту й не зберігаються, тож історії оцінки немає. Асистент усе одно може проаналізувати будь-який період, прочитавши самі відгуки.
  • Запити розподілені нижче лімітів Google і повторюються з експоненційною затримкою, якщо Google просить сповільнитися.
  • Якщо Google переклав відгук, ми зберігаємо оригінал клієнта й переклад окремо.
  • Відповіді, написані безпосередньо в Google Картах, теж з'являються в ReviewSmith і враховуються в частці відповідей (з позначкою «вручну»).

Публікація відповідей

Під час публікації ReviewSmith надсилає відповідь у Google як публічну відповідь власника. Google може затримати відповідь на модерацію (pending) або відхилити (rejected, із причиною, наприклад «персональні дані»). Статус видно у Вхідних і в результаті get_review. Google обмежує відповідь 4 096 байтами (близько 2 000 кириличних або 4 000 латинських символів).

Відключення

Натисніть Відключити на сторінці інтеграції. Ми відкличемо токен у Google, одразу видалимо його з нашої бази й видалимо кешований вміст відгуків Google (завжди протягом 30 днів). Ваші чернетки, шаблони, голос бренду й історія роботи залишаться в акаунті. Доступ також можна прибрати в Google-акаунті: Безпека → Сторонні застосунки й сервіси.

Помилки й що робити

Повідомлення Причина Що робити
Очікує схвалення / google_not_approved Квота API нашого проєкту ще 0 Нічого — синхронізація почнеться після схвалення
google_auth — підключіть Google знову Доступ відкликано, змінено пароль або токен прострочено Натисніть Підключити Google ще раз
google_permission Google-акаунт не є власником/менеджером локації Попросіть власника профілю додати вас менеджером
google_invalid — локацію не верифіковано API відгуків працює лише для верифікованих локацій Завершіть верифікацію в Business Profile
google_rate_limited Google попросив сповільнитися Повтор відбудеться автоматично

Дані користувачів Google

Як ми отримуємо, використовуємо, зберігаємо й видаляємо дані Google, разом із положенням про обмежене використання (Limited Use), описано в розділі Безпека й дані Google.