google-business-profile-api
Use when working with Google Business Profile API - managing business listings, reviews, posts, photos, local business data, or performance metrics. Also use when working with GBP federated APIs for reviews, Q&A, or business information.
| Model | Source |
|---|---|
| sonnet | pack: google-apis |
Full Reference
┏━ 🔧 google-business-profile-api ━━━━━━━━━━━━━━━┓ ┃ Use when working with Google Business Profile … ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
Google Business Profile API
Section titled “Google Business Profile API”Google Business Profile API uses a federated model — 8 separate specialized APIs replaced the original monolithic mybusinessbusinessinformation API. Reviews, Posts, and Media remain on the legacy v4.9 endpoint.
Quick Reference
Section titled “Quick Reference”| API | Purpose | Base URL |
|---|---|---|
| My Business Business Information v1 | Locations, attributes, categories | mybusinessbusinessinformation.googleapis.com/v1/ |
| My Business Account Management v1.1 | Accounts, admins | mybusinessaccountmanagement.googleapis.com/v1/ |
| Business Profile Performance v1 | Insights, metrics, search keywords | businessprofileperformance.googleapis.com/v1/ |
| My Business Notifications v1.2 | Pub/Sub review alerts | mybusinessnotifications.googleapis.com/v1/ |
| My Business Verifications v1 | Verify listings | mybusinessverifications.googleapis.com/v1/ |
| My Business Place Actions v1 | Links (menu, order, book) | mybusinessplaceactions.googleapis.com/v1/ |
| My Business Lodging v1.2 | Hotel-specific data | mybusinesslodging.googleapis.com/v1/ |
| Google My Business API v4.9 | Reviews, Posts, Media (not yet v1) | mybusiness.googleapis.com/v4/ |
Auth: OAuth 2.0 only — scope https://www.googleapis.com/auth/business.manage. No service accounts.
API Access: Requires approval via GBP API request form before APIs appear in Cloud Console.
Reference Index
Section titled “Reference Index”| File | What’s inside |
|---|---|
reference/architecture.md | Federated model overview, all base URLs, endpoint tables for all 8 APIs |
reference/auth.md | OAuth 2.0 setup, token exchange, Python + Node.js auth examples |
reference/locations.md | Business Information API — get, list, create, update, filter locations |
reference/reviews.md | Reviews — list, reply, batch get (v4.9 endpoint, not v1) |
reference/posts.md | Local posts — standard, event, offer post types |
reference/insights.md | Performance API — daily metrics, search keyword impressions |
reference/notifications.md | Pub/Sub setup, notification types, webhook handlers |
reference/accounts.md | Account Management API — accounts, admins |
reference/quotas.md | Rate limits, quota increase process, best practices |
reference/errors.md | HTTP status codes, exponential backoff, validateOnly |
reference/deprecations.md | Discontinued APIs, migration paths from v4 to v1 |
Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.