Before you start: Set up a Google Cloud OAuth app and enable both required APIs (listed below).
Before You Start
- A Google Cloud OAuth app registered in Hiveku’s Settings > OAuth Apps
- Two APIs enabled in your Google Cloud project:
- My Business Account Management API
- Business Profile Performance API
- A Google account that owns or manages at least one verified location at business.google.com
Connect via OAuth
Select your Google OAuth app
Pick the Google app you registered. If you haven’t created one yet, start with Set up a Google Cloud OAuth app.
Authorize with Google
Click Authorize. You’ll be redirected to Google, sign in with the account that manages your business, and grant the scope:
Pick a location
Hiveku auto-discovers every GBP account and location the Google user manages. A modal opens listing them — pick the location to connect.Behind the scenes, locations are identified as:You don’t normally need those IDs — the UI handles the selection.
What You Can Do
Depending on your Hiveku plan and the features enabled, a connected GBP location lets you:- View insights — impressions, direction requests, phone calls, website visits
- Post updates — offers, events, announcements
- Respond to reviews
- Manage business info — hours, photos, attributes (where feature-gated)
Connect Multiple Locations
If you manage a chain or multi-location business, repeat the flow for each location. Each becomes its own connection in Hiveku.Verify the Connection
- The location name appears on the SEO dashboard
- Local insights start populating within a few minutes
- If you post an update from Hiveku, it should appear on the live Business Profile within a few minutes (Google sometimes queues posts)
Troubleshooting
No locations show in the picker
No locations show in the picker
The authorized Google account doesn’t own or manage any verified Business Profile locations. Go to business.google.com, confirm the account has access, and make sure each location is Verified (not pending). Then disconnect and reconnect.
'business.manage not granted' error
'business.manage not granted' error
The scope wasn’t consented during the authorization flow. Reconnect and make sure you grant all requested permissions. Also check that
business.manage is listed on your OAuth consent screen scope list.'API not enabled' error
'API not enabled' error
GBP requires two APIs enabled in your Google Cloud project. Go to APIs & Services > Library and enable both:
- My Business Account Management API
- Business Profile Performance API
Location exists but API says 'not found'
Location exists but API says 'not found'
New or recently migrated GBP listings need to be fully verified with Google before the API can return them. Check verification status at business.google.com. Postcard and phone verification typically clear within a few days; video verification is faster.
Insights look incomplete or delayed
Insights look incomplete or delayed
GBP insights data has inherent delays (typically 1-3 days lag for some metrics). Confirm the same data is visible in your Business Profile dashboard — if it’s missing there too, it’s a Google data-pipeline delay, not a connection problem.
What’s Next?
Connect Search Console
Pair local data with organic search
SEO
Build out the full SEO stack