--- title: Google Reviews API Integration on Truto slug: googlereviews category: Marketing Automation canonical: "https://truto.one/integrations/detail/googlereviews/" --- # Google Reviews API Integration on Truto **Category:** Marketing Automation **Status:** Beta ## MCP-ready AI tools Truto exposes 14 tools for Google Reviews that AI agents can call directly. - **list_all_google_reviews_reviews** — List Google Business Profile reviews for a specified location. Returns: name, reviewId, reviewer, starRating, comment, createTime, updateTime, reviewReply, reviewMediaItems, reviewReplyUrl. Required: account_id, location_id. Max 50 per page. - **get_single_google_reviews_review_by_id** — Get a single Google Business Profile review by id. Returns: name, reviewId, reviewer, starRating, comment, createTime, updateTime, reviewReply, reviewMediaItems, reviewReplyUrl. Required: account_id, location_id, id. - **google_reviews_reviews_create_reply** — Create or update the owner reply to a specific Google Business Profile review. A reply is created if one does not already exist. Returns: comment, updateTime, reviewReplyState, policyViolation. Required: account_id, location_id, review_id, comment. - **google_reviews_reviews_delete_reply** — Delete the reply to a specific Google Business Profile review permanently. The location must be verified for this operation to succeed. Returns an empty 204 response on success. Required: account_id, location_id, review_id. - **google_reviews_reviews_bulk_get** — Batch retrieve reviews across up to 50 verified Google Business Profile locations in a single request. Returns location review records with name (location resource name) and a full review object including reviewId, starRating, comment, reviewer, reviewReply, reviewMediaItems, and reviewReplyUrl. Required: account_id, locationNames. - **list_all_google_reviews_accounts** — List Google Business Profile accounts accessible to the authenticated user. Returns: name, accountName, type, role, verificationState, vettedState, permissionLevel. No required parameters. The numeric part of `name` is the account_id used by locations and reviews. - **get_single_google_reviews_account_by_id** — Get a single Google Business Profile account by account id. Returns: name, accountName, type, role, verificationState, vettedState, permissionLevel. Required: id. - **create_a_google_reviews_account** — Create a Google Business Profile location group or organization account. Returns the created account: name, accountName, type, role, verificationState, vettedState. Required in body: accountName, type. Organization accounts also require primaryOwner. - **update_a_google_reviews_account_by_id** — Update a Google Business Profile account. Returns the updated account. Required: id and update_mask. Only accountName is updatable. - **list_all_google_reviews_locations** — List business locations under a Google Business Profile account. Returns: name, title, storeCode, storefrontAddress, phoneNumbers, categories, websiteUri, regularHours, latlng, openInfo, metadata, languageCode. Required: account_id. Optional: read_mask. Max 100 per page. - **get_single_google_reviews_location_by_id** — Get a single Google Business Profile location by location id. Returns: name, title, storeCode, storefrontAddress, phoneNumbers, categories, websiteUri, regularHours, latlng, openInfo, metadata, languageCode. Required: id. Optional: read_mask. - **create_a_google_reviews_location** — Create a business location under a Google Business Profile account. Returns the created location. Required: account_id, plus title and categories.primaryCategory in the body. A storefrontAddress or serviceArea is also required. - **update_a_google_reviews_location_by_id** — Update a Google Business Profile location. Returns the updated location. Required: id and update_mask. Only fields named in update_mask are changed. - **delete_a_google_reviews_location_by_id** — Delete a Google Business Profile location. Returns an empty body on success. Required: id. Locations that cannot be deleted via the API must be removed through the Business Profile UI. ## How it works 1. **Link your customer's Google Reviews account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Google Reviews.** The Proxy API is a 1-to-1 mapping of the Google Reviews API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Embed reputation management inside vertical SaaS** — Give restaurant, healthcare, or home services platforms a native way to surface Google reviews next to their core operational data, so users never leave the app to check what customers are saying. - **Power a unified review response inbox** — Let support and marketing teams read Google reviews and publish owner replies from the same interface they use for email, chat, and tickets — turning reviews into a first-class support channel. - **Scale multi-location reputation for franchises** — Franchise management and enterprise marketing platforms can ingest reviews across hundreds of locations in bulk and drive reply-rate SLAs from a single corporate dashboard. - **Automate Google Business Profile provisioning** — Location data management and local SEO tools can create and update Google locations programmatically whenever a customer opens a new storefront or changes hours, eliminating manual GBP edits. - **Trigger AI-drafted responses to negative reviews** — Customer experience platforms can watch for low star ratings, generate LLM-drafted apology replies, and publish approved responses back to Google — closing the loop automatically. ## What you can build - **Multi-location review feed** — Pull reviews across every connected account and location into a unified, filterable feed using bulk review ingestion for up to 50 locations per call. - **Two-way owner reply publishing** — Let users draft, edit, and post owner responses from your UI, with edits syncing back to Google via the reply endpoint. - **Reply deletion and moderation workflows** — Allow managers to retract published replies directly from your app when responses need to be corrected or removed. - **Location provisioning pipeline** — Create new Google Business Profile locations with storefront address, categories, and hours whenever a new site is onboarded in your platform. - **Bulk hours and location detail sync** — Push holiday hours, address changes, and category updates to hundreds of locations at once from a single control panel in your app. - **Star rating alerts and sentiment dashboards** — Poll for new reviews, score them by star rating and comment sentiment, and route 1–2 star reviews into urgent workflows or tickets. ## FAQs ### How does authentication work for Google Reviews? Google Business Profile uses OAuth 2.0. Truto handles the full OAuth flow, token storage, and refresh so your end users just click connect — you never touch client secrets or refresh tokens directly. ### Can we fetch reviews for many locations at once? Yes. Truto exposes a bulk review fetch that retrieves reviews for up to 50 locations in a single call, which is the recommended pattern for multi-location and franchise use cases to avoid per-location rate limits. ### Can we both read and reply to reviews? Yes. You can list reviews, fetch a single review by ID, create or update owner replies, and delete replies. Updating an existing reply uses the same create-reply operation, which overwrites the prior response on Google. ### Can we create and update Google Business Profile locations? Yes. Truto supports listing, fetching, creating, updating, and deleting locations, as well as listing and creating accounts — enabling full provisioning and ongoing management of location metadata like hours, address, and categories. ### How fresh is review data? Data freshness depends on how often you poll. Truto does not push real-time review webhooks from Google (Google Business Profile does not offer public review webhooks), so most customers schedule frequent polls of the list and bulk-get endpoints to detect new reviews. ### What about Google Business Profile API rate limits and access? The Google Business Profile API requires an approved quota project from Google and enforces strict per-minute quotas. Truto's bulk endpoints and unified pagination help you stay within limits, but your end users' Google accounts must have management access to the locations you query.