Connect Google Business Profile
Connect the Google account that manages your locations, understand what Google's API approval means, and fix common connection errors.
ReviewSmith reads your Google reviews and publishes the replies you approve through Google's official
Business Profile APIs. You sign in with Google and grant one permission: manage your Business
Profile (business.manage). We never see your Google password.
Connect
- Open https://reviewsmith.com.ua/app/integrations/google, confirm that you are an owner or manager of the Business Profile (or that its owner authorized you), and click Connect Google.
- Choose the Google account that is an owner or manager of your Business Profile locations.
- Approve the permission. You return to ReviewSmith, which lists the accounts and locations it can see.
- Select the locations to track. The first sync loads your reviews (large profiles take a few runs); after that new reviews arrive about every 30 minutes.
Only verified locations can return reviews and accept replies through the API. If a location is not verified, finish verification in Business Profile first.
What "pending Google approval" means
Google gives Business Profile API access to applications only after reviewing them. Until our Google Cloud project is approved, Google allows 0 requests per minute, and the integration page shows Google connection pending. In this state:
- you can still use demo data, CSV imports, activity analytics, brand voice, templates and drafts;
- tools that need Google (syncing, publishing or deleting replies) return a clear
google_not_connectedorgoogle_not_approvederror instead of failing silently; - as soon as Google grants the quota, syncing starts automatically, with no action from you.
How syncing and caching work
- New and updated reviews are fetched every 30 minutes per location, newest first, stopping as soon as known reviews are reached. A full refresh runs weekly; reviews that no longer exist on Google are removed.
- Review content is kept only as a short-lived cache, as Google's terms require: every cached review
expires at most 30 days after it was fetched and is deleted by a daily job. An expired review is never
shown — it is fetched live from Google again.
list_reviewsalso refreshes a location from Google when its data is older than 30 minutes. - Figures from
get_review_statsand the dashboard (Google's average rating, total reviews, unanswered reviews, response rate) are fetched from Google at the moment you ask and are not stored, so there is no rating history. Your assistant can still analyse any period by reading the reviews themselves. - Requests are paced below Google's limits and retried with exponential backoff when Google asks us to slow down.
- If Google has translated a review, we keep the customer's original text and the translation separately.
- Replies you write directly in Google Maps also appear in ReviewSmith and count toward the response rate (marked as "manual").
Publishing replies
When you publish, ReviewSmith sends the reply to Google as the business owner's public response. Google
may hold a reply for moderation (pending) or reject it (rejected, with a reason such as personal
information). The reply status is shown in the Inbox and returned by get_review. Replies are limited by
Google to 4,096 bytes (about 2,000 Cyrillic or 4,000 Latin characters).
Disconnecting
Click Disconnect on the integration page. We revoke the token with Google, delete it from our database immediately and delete the cached Google review content (always within 30 days). Drafts you wrote, templates, brand voice and your activity history stay in your account. You can also remove access from your Google Account under Security → Third-party apps & services.
Errors and what to do
| Message | Cause | What to do |
|---|---|---|
Google connection pending / google_not_approved |
The API quota for our project is still 0 | Nothing — syncing starts once Google approves |
google_auth — reconnect Google |
Access was revoked, the password changed, or the token expired | Click Connect Google again |
google_permission |
The Google account isn't an owner/manager of that location | Ask the profile owner to add you as a manager |
google_invalid — location not verified |
Reviews API works only for verified locations | Complete verification in Business Profile |
google_rate_limited |
Google asked us to slow down | It is retried automatically |
Google user data
How we access, use, store and delete Google data — including the Limited Use disclosure — is described in Security and Google user data.