Use Google Business

This guide shows the normal Google Business workflow in Kavenio: connect a Google account, select a location, publish content, manage the listing, read reviews, and fetch analytics.

1. Connect Google Business

Start the hosted OAuth flow with the same connect endpoint used by other platforms.

kavenio connect begin \
  --profile-id customer_user_123 \
  --platform googlebusiness \
  --return-to https://app.example.com/accounts

The API returns an authorizationUrl. Open it for the user. After Google redirects back, Kavenio stores the encrypted OAuth credential and exposes only safe account and location metadata.

2. Select a location

List available locations:

kavenio connect googlebusiness-locations --account-id acc_123 --page-size 25

Select the location to manage:

kavenio connect googlebusiness-select-location \
  --account-id acc_123 \
  --profile-id customer_user_123 \
  --location-id 9281089117903930794

Account health reports reconnect, missing scope, missing permission, unverified listing, and missing selected-location issues.

3. Publish or schedule a post

Use POST /v1/posts or the CLI posts create command. Google Business-specific fields stay inside the target object.

{
  "profileId": "customer_user_123",
  "content": "New seasonal menu is live.",
  "platforms": [
    {
      "platform": "googlebusiness",
      "accountId": "acc_123",
      "platformSpecificData": {
        "topicType": "STANDARD",
        "callToAction": "ORDER",
        "ctaUrl": "https://example.com/order"
      }
    }
  ],
  "scheduledFor": "2026-06-20T15:00:00.000Z"
}

kavenio posts create \
  --profile-id customer_user_123 \
  --content "New seasonal menu is live." \
  --scheduled-for 2026-06-20T15:00:00.000Z \
  --platform googlebusiness:acc_123 \
  --topic-type STANDARD \
  --call-to-action ORDER \
  --cta-url https://example.com/order

4. Upload media

Use shared media endpoints, then attach the public URL to a post or create a Google Business photo.

kavenio media presign --file-name menu.jpg --content-type image/jpeg

kavenio accounts gmb-media-create \
  --account-id acc_123 \
  --source-url https://cdn.example.com/menu.jpg \
  --category MENU

5. Manage listing data

Use account-scoped commands for live listing data:

kavenio accounts gmb-location-details --account-id acc_123
kavenio accounts gmb-attributes --account-id acc_123
kavenio accounts gmb-services --account-id acc_123
kavenio accounts gmb-food-menus --account-id acc_123
kavenio accounts gmb-place-actions --account-id acc_123

Update commands take JSON payload files, for example:

kavenio accounts gmb-food-menus-update --account-id acc_123 --file menus.json

6. Manage reviews

Read one account’s Google Business reviews:

kavenio accounts gmb-reviews --account-id acc_123 --page-size 25

Read the shared inbox:

kavenio accounts inbox-reviews --platform googlebusiness --limit 25

Reply or delete a reply:

kavenio accounts gmb-review-reply \
  --account-id acc_123 \
  --review-id review_123 \
  --comment "Thanks for the review."

kavenio accounts gmb-review-reply-delete \
  --account-id acc_123 \
  --review-id review_123

7. Check verification

kavenio accounts gmb-verifications --account-id acc_123
kavenio accounts gmb-verification-options --account-id acc_123 --language-code en-US

Starting and completing verification calls Google live:

kavenio accounts gmb-verification-start --account-id acc_123 --method SMS --phone-number +15551234567
kavenio accounts gmb-verification-complete --account-id acc_123 --verification-id verification_123 --pin 12345

8. Fetch analytics

Performance metrics are daily:

kavenio analytics googlebusiness-performance \
  --account-id acc_123 \
  --metrics WEBSITE_CLICKS,CALL_CLICKS,BUSINESS_DIRECTION_REQUESTS \
  --start-date 2026-06-01 \
  --end-date 2026-06-07

Search keywords are monthly:

kavenio analytics googlebusiness-search-keywords \
  --account-id acc_123 \
  --start-month 2026-05 \
  --end-month 2026-06

Google Business analytics can lag provider-side availability, and keyword rows may use threshold values instead of exact impression counts. Exact rows include valueType: "exact" and impressions; threshold rows include valueType: "threshold" and threshold.

Live smoke checklist

Before running live smoke tests, confirm:

Business Profile API access is approved.
OAuth callback URLs match the API environment.
The account has a verified Google Business location.
The test user can manage posts, photos, reviews, menus, services, attributes, verification, place actions, and analytics for that location.
GOOGLE_BUSINESS_CLIENT_ID and GOOGLE_BUSINESS_CLIENT_SECRET are set.

​1. Connect Google Business

​2. Select a location

​3. Publish or schedule a post

​4. Upload media

​5. Manage listing data

​6. Manage reviews

​7. Check verification

​8. Fetch analytics

​Live smoke checklist