canonical: https://jentic.com/apis/googleapis.com/mybusinessnotifications

# Google My Business Notifications API

The My Business Notifications API configures Pub/Sub-based notification settings for Google Business Profile accounts. It exposes a single notificationSetting resource per account that controls which Business Profile events (new reviews, questions, status changes) are pushed to a Cloud Pub/Sub topic. Pair it with the Q&A and v4 reviews endpoints to build event-driven Business Profile workflows instead of polling.

## For AI agents

Configure which Google Business Profile events get pushed to a Cloud Pub/Sub topic. Use to drive event-based workflows for reviews, questions, and listing changes.

## Scope

Does not deliver event payloads, send emails, or push mobile notifications - use only to configure which Business Profile events publish to a Cloud Pub/Sub topic.

## Capabilities

- Read the current notification setting for a Business Profile account
- Subscribe an account's events to a Cloud Pub/Sub topic
- Select which event types - reviews, questions, listing changes - to receive
- Update the target Pub/Sub topic when migrating environments
- Disable notifications by clearing the Pub/Sub topic on the setting
- Verify which events the current setting is configured to deliver

## Use cases

### Event-Driven Review Reply

Instead of polling every location for new reviews, teams subscribe to Business Profile review events on a Pub/Sub topic. When a new review arrives, a worker picks up the event and triggers reply automation against the v4 reviews endpoint, cutting average response time without burning quota on polling.

Example prompt: PATCH /v1/{name} with pubsubTopic set to projects/{project}/topics/{topic} and notificationTypes including NEW_REVIEW, then verify with a GET.

### Real-Time Q&A Monitoring

Customer questions on Business Profile listings need quick answers. Subscribing the account's notification setting to NEW_QUESTION and NEW_ANSWER events on a Pub/Sub topic streams every question into a queue, enabling support to triage and reply through the My Business Q&A API within minutes.

Example prompt: PATCH /v1/{name} with notificationTypes set to NEW_QUESTION, NEW_ANSWER and the support-team Pub/Sub topic, then confirm via GET.

### Environment Migration

When teams move Pub/Sub from one Google Cloud project to another, the Business Profile notification setting must be repointed without dropping events. Update the notificationSetting's pubsubTopic to the new fully qualified topic and Google starts publishing to the new project with no other changes required.

Example prompt: PATCH /v1/{name} with pubsubTopic set to the new project topic and updateMask=pubsubTopic, then verify message delivery in the new project.

### AI Agent Listing Watcher

An AI agent connected through Jentic owns a Business Profile inbox: every new review, question, or listing change lands in a Pub/Sub topic, the agent enriches the event, and routes it to the right responder. Jentic isolates the OAuth credentials so the agent never sees Google client secrets while still being able to reconfigure the notification setting on demand.

Example prompt: Search Jentic for 'configure Google Business Pub/Sub notifications', load accounts.notificationSetting.update, and execute with the desired notificationTypes and pubsubTopic.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /v1/{name} | Get the notification setting for an account |
| PATCH | /v1/{name} | Update the Pub/Sub topic and event types |

## Key resources

- **notificationSetting** — Per-account configuration that selects events and the Pub/Sub topic they publish to

## Why Jentic

- **Setup:** Wiring the My Business Notifications API by hand means setting up Google OAuth 2.0 for Business Profile access, minting short-lived bearer tokens, and wiring the Cloud Pub/Sub notification setting yourself against the mybusinessnotifications.googleapis.com host. Through Jentic you install once, import the My Business Notifications API from the API Directory, store the OAuth credential once, and your agent calls it.
- **Permission scoping:** This API puts the account notification-setting name in the URL path (/v1/{name}), so a rule can pin your agent to one Business Profile account's notification setting: it can read that setting and nothing else. You choose the operations it may call, so patching which events publish to Pub/Sub is not included unless you add it.
- **Credential handling:** Your Google OAuth credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'subscribe to Google Business review events' or 'read notification settings', and Jentic returns the matching Notifications operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **My Business Q&A API** — Reads and writes questions and answers triggered by NEW_QUESTION events
- **Google My Business API (v4)** — Hosts the reviews endpoints used after a NEW_REVIEW event
- **My Business Business Information API** — Receives GOOGLE_UPDATE events when listing fields drift
- **My Business Account Management API** — Provides invitation events that complement listing notifications

## FAQ

### What authentication does the My Business Notifications API use?

OAuth 2.0 with the https://www.googleapis.com/auth/business.manage scope. The user must be an admin on the target Business Profile account and the service account behind the Pub/Sub topic must grant publish rights to mybusiness-api-pubsub@system.gserviceaccount.com. Jentic stores OAuth tokens in your Jentic One instance.

### Which event types can I subscribe to?

The notificationSetting accepts notificationTypes such as NEW_REVIEW, UPDATED_REVIEW, NEW_QUESTION, NEW_ANSWER, and GOOGLE_UPDATE. Pick the subset relevant to your workflow to avoid noisy event traffic.

### What are the rate limits for the My Business Notifications API?

Default quota is 0 QPM until Business Profile API access is approved. Once approved, the API itself is rarely rate-limited because the resource is read or patched infrequently; the bottleneck is downstream consumption of the Pub/Sub topic.

### How do I switch the Pub/Sub topic through Jentic?

Search Jentic for 'change Google Business notification topic', load accounts.notificationSetting.update, and execute it with the new pubsubTopic and updateMask=pubsubTopic. Jentic handles OAuth refresh in the background.

### Does this API deliver the actual review or question content?

Notifications carry the resource name and event type, not the full payload. After receiving an event, fetch the resource via the v4 Google My Business reviews endpoint or the My Business Q&A API to retrieve the body.

### Can I limit what my agent is allowed to do with the My Business Notifications API?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use, and this API keeps the notification-setting name in the URL path (/v1/{name}), so a rule can pin the agent to a single Business Profile account's setting. You can allow only the GET so the agent reads the current notification configuration and nothing else, keeping the PATCH that changes which events publish to Pub/Sub off the table unless you grant it. Your Google OAuth credential stays in your instance and is injected at call time, so the agent never sees the client secret.