Google Business Profile

Publish updates, events and offers to Google Business Profile (googlebusiness) with POST /v1/posts and platform: "googlebusiness".

The same account also serves reviews, listing management (hours, photos, services, menus, verification) and location-level performance metrics.

Quick reference

Before you start

Google Business Profile requires a verified location.

Posts appear in Google Search, Google Maps and the Knowledge Panel rather than in a social feed. They contribute to local search ranking.

A post stays visible for about 7 days before Google archives it, so post at least weekly.

Videos are not supported. A text-only post works but gets less visibility than one with an image or a call-to-action button.

Connect

Call GET /v1/connect/googlebusiness with profileId (Get OAuth connect URL). Send the user's browser to the returned authUrl.

After Google's consent screen the user picks which location to connect. Zernio hosts that screen by default.

To build it yourself, pass headless=true and use List locations and Select location.

The connecting accounts guide covers both modes and scopes. Account health reports what a connected account can do.

import Zernio from '@zernio/node';

const zernio = new Zernio();

const { data: connect } = await zernio.connect.getConnectUrl({
  path: { platform: 'googlebusiness' },
  query: { profileId: '66a1f0c2a4b9d3e8f1a2b3c4', redirect_url: 'https://myapp.com/callback' }
});
// Send the user's browser to connect.authUrl

Response (200):

{
  "authUrl": "https://accounts.google.com/o/oauth2/v2/auth?client_id=...",
  "state": "..."
}

After the location is selected, the user lands on redirect_url with these params appended:

connected=googlebusiness&profileId=...&accountId=...

One account is one location. An account that manages several locations posts to the others with locationId; see Multi-Location Posting.

Publish

A plain post becomes a STANDARD update on the connected location. Call POST /v1/posts with:

• content
• at most one image in mediaItems
• a platforms entry with platform: "googlebusiness"
• publishNow: true

curl -X POST https://zernio.com/api/v1/posts \
  -H "Authorization: Bearer $ZERNIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Open all holiday weekend. Stop by for the seasonal menu.",
    "mediaItems": [
      {"type": "image", "url": "https://cdn.example.com/holiday-special.jpg"}
    ],
    "platforms": [
      {"platform": "googlebusiness", "accountId": "66b2e19d8c3f5a7e9d0b1c2d"}
    ],
    "publishNow": true
  }'

Response (201):

{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "platforms": [
      {
        "platform": "googlebusiness",
        "status": "published",
        "platformPostId": "1234567890123456789",
        "platformPostUrl": "https://business.google.com/..."
      }
    ]
  }
}

Replace publishNow with scheduledFor and timezone to schedule it.

Call-to-action buttons, text-only posts and edits are on Posts & Content Types. topicType: "EVENT" and "OFFER" are on Event & Offer Posts.

Common errors

The publish-time errors are in Fields, Media & Limits, and Error handling covers the envelope.

In this section

Related

• Connecting accounts: the OAuth flow and the location selection step.
• Create post: every field of the request.
• Media uploads: upload images instead of hosting them.
• Reviews: the inbox API for reviews.
• Performance metrics: daily impressions, clicks, calls, directions and bookings.