> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mavera.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Business Profile

> Integrate Mavera with Google Business Profile — multi-location review analysis, local persona creation, location content strategy, and response template generation

## Overview

Pull data from **Google Business Profile** (Reviews, Locations, Insights) → analyze with **Mavera** (Mave Agent, Personas, Focus Groups, Generate) → get location-specific brand intelligence, geo-targeted personas, and templated review responses for multi-location businesses.

<Info>
  **Google Business Profile API** — Base URL: `https://mybusiness.googleapis.com/v4/`. Auth: **OAuth 2.0** (service account or user consent). Rate limits: **300 queries/min**. Requires a verified Google Business Profile.
</Info>

<Warning>
  Google is migrating the My Business API to the **Google Business Profile API** (`https://mybusinessbusinessinformation.googleapis.com/v1/`). The review endpoints are now under **Account Management API**. Code examples use both legacy and new endpoints — check [migration guide](https://developers.google.com/my-business/content/overview) for your account status.
</Warning>

***

## Prerequisites

<Steps>
  <Step title="Google Cloud project">Create a project in [Google Cloud Console](https://console.cloud.google.com/) with the My Business API enabled.</Step>
  <Step title="OAuth credentials">Set up OAuth 2.0 credentials (Desktop or Service Account). For service accounts, enable domain-wide delegation.</Step>
  <Step title="Business Profile access">The OAuth user must be an owner or manager of the Google Business Profile locations.</Step>
  <Step title="Mavera API key">Get your key from [Mavera dashboard](https://app.mavera.io/settings/api-keys).</Step>

  <Step title="Environment variables">
    ```bash theme={"dark"}
    export GOOGLE_ACCESS_TOKEN="ya29.xxxxx"
    export GOOGLE_ACCOUNT_ID="accounts/123456789"
    export MAVERA_API_KEY="mvra_live_xxxxx"
    ```
  </Step>
</Steps>

***

## Jobs

| # | Job                                                              | Google Data           | Mavera Surface  | Output                              |
| - | ---------------------------------------------------------------- | --------------------- | --------------- | ----------------------------------- |
| 1 | [Multi-Location Review Analysis](multi-location-analysis)        | batchGetReviews       | Mave Agent      | Cross-location feedback comparison  |
| 2 | [Local Persona Creation](local-personas)                         | Reviews with location | Custom Personas | Geo-specific customer personas      |
| 3 | [Review Themes → Local Content Strategy](local-content-strategy) | Themes per location   | Generate        | Location-specific marketing content |
| 4 | [Response Template Generation](response-templates)               | Common review themes  | Generate        | Per-theme response templates        |

***

## Rate Limits & Production Notes

| Google Endpoint      | Limit                     | Strategy                                |
| -------------------- | ------------------------- | --------------------------------------- |
| All GBP endpoints    | 300 queries/min           | Generous; use 300ms delays per location |
| Reviews per location | Paginate with `pageToken` | Max 50 per page                         |
| Location list        | Single call per account   | Cache location IDs daily                |
| Reply to review      | Per-review write          | Queue and rate-limit to 1/sec           |

<Warning>
  Google is migrating the **My Business API** to new individual APIs (Business Information, Business Performance, etc.). Review endpoints may change. Monitor the [deprecation timeline](https://developers.google.com/my-business/content/overview) and update base URLs accordingly.
</Warning>

**Checklist:**

* OAuth 2.0 required (no API key option for business data)
* Star ratings are strings (`ONE`-`FIVE`), not integers
* Paginate reviews with `nextPageToken`
* Cache location IDs and metadata (rarely changes)
* Service accounts need domain-wide delegation for Business Profile access
* Monitor Mavera credits at [Dashboard](https://app.mavera.io/settings/usage)

***

<CardGroup cols={3}>
  <Card title="All Integrations" icon="plug" href="/integrations" />

  <Card title="Google Business API" icon="google" href="https://developers.google.com/my-business" />

  <Card title="Personas" icon="user" href="/features/personas" />

  <Card title="Focus Groups" icon="users" href="/features/focus-groups" />

  <Card title="Generate" icon="wand-magic-sparkles" href="/features/generate" />

  <Card title="Mave Agent" icon="brain" href="/features/mave-agent" />
</CardGroup>