Google Business Profile

Home / Docs / Google Business

Provider

Publish local-post updates — standard, offer, and event — to Google Business Profile locations you manage. Posts surface in Google Search and Maps panels for the location.

Requirements

A Google account with at least one verified Business Profile location.
The account must have Manager or Owner role on the location.
The location must be verified — unverified locations cannot receive posts.

Spec

Account type

Google account with verified Business Profile

Auth

Google OAuth 2.0

Token type

1-hour access token + refresh token (Postli refreshes automatically)

Post types

Standard, Offer, Event

Body length

Up to 1,500 characters per post

Image

JPEG, PNG · 250×250 to 5,200×5,200 · 10 KB – 5 MB

Video

Not currently supported on local posts via API

CTA buttons

Book, Order, Buy, Learn more, Sign up, Call

Auto-comments

Not applicable — local posts do not support comments

Connect your Google Business Profile

Postli manages the OAuth app centrally — you don’t need to create a Google Cloud project or paste any API credentials. Go to Integrations → Google Business → Connect and approve the Business Profile management scope on Google’s consent screen. Then pick which location to connect — multiple locations from one account are supported (connect each as a separate destination).

Scopes Postli requests:

https://www.googleapis.com/auth/business.manage # manage Business locations https://www.googleapis.com/auth/userinfo.email # identify connected user

Post types in detail

Standard update

General news or announcement. Body up to 1,500 characters, optional image, optional CTA button. The most common post type for ongoing engagement.

Offer

Promotional offer with a defined start and end date. Optional coupon code, terms, and redemption URL. Postli’s short link in the redemption URL field gives you click attribution from Google Search panels into your store.

Event

Event with a title, start and end datetime, and optional CTA. Useful for in-store events, sales windows, or product drops.

Auto-comments

Local posts on Google Business Profile do not support user comments — engagement is limited to clicks on the CTA button and view count. Postli’s auto-comment feature is therefore disabled for this provider.

Rate limits

Google’s Business Profile API uses a per-project quota system (default 10 QPS, 30,000 / day). Postli’s production project is provisioned for production traffic; merchant-level limits apply per location.

Local-post deprecation note. Google has progressively reduced the prominence of local posts in Search panels over the last two years. Engagement is now lower than for the equivalent post on Facebook or Instagram. Plan content accordingly.

Gotchas & best practices

Verified locations only. If a location is in Pending verification, posts will return a 403.
One location at a time. Each location is a separate destination — if you manage 12 stores, connect 12 destinations.
No video. The local-post API supports image only; video uploads are rejected.
Offer dates required. Offer posts must have startDate and endDate; Postli enforces this in the channel tab.
Refresh token revocation. If the merchant revokes Postli’s access at myaccount.google.com/permissions, the refresh token is invalidated and a re-auth is required.

Webhooks

Postli does not subscribe to Business Profile webhooks (these require Google Cloud Pub/Sub setup per project and are not yet exposed in Postli). Engagement is polled.