Підключення Google Business Profile
Підключіть Google-акаунт, що керує вашими локаціями, дізнайтеся, що означає схвалення API від Google, і виправте типові помилки підключення.
ReviewSmith читає ваші відгуки в Google і публікує схвалені вами відповіді через офіційні API Google
Business Profile. Ви входите через Google і надаєте один дозвіл: керування профілем компанії
(business.manage). Ми ніколи не бачимо вашого пароля Google.
Підключення
- Відкрийте https://reviewsmith.com.ua/app/integrations/google, підтвердьте, що ви власник або менеджер профілю компанії (або що власник вас уповноважив), і натисніть Підключити Google.
- Оберіть Google-акаунт, який є власником або менеджером ваших локацій у Business Profile.
- Надайте дозвіл. Ви повернетеся в ReviewSmith, де буде список акаунтів і локацій, які він бачить.
- Оберіть локації для відстеження. Перша синхронізація завантажить ваші відгуки (великі профілі — за кілька запусків), далі нові відгуки з'являються приблизно кожні 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.