• Applicable Software: MokonyxSocial
  • Min Version Number: 01.03.00 and later
  • Max Version Number: Not Applicable

Connect your Google Business Profile and MokonyxSocial can post updates that show up right on your business listing in Google Search and Maps. Heads up: Google keeps this behind an approval process, so there's a bit of setup — this guide walks you through it.

What you need

  • A verified Google Business Profile for your business, with a location you manage (you'd see it at business.google.com).
  • A free Google Cloud project (that's Google's developer area) — don't worry, the steps below cover it.
  • Google's approval to use the Business Profile tools: Google makes you fill out a short access request form and wait to be approved before this works.
  • A special sign-in access token that gives MokonyxSocial permission to post for you.

Get your credentials

This one takes a few steps because Google requires it. Take your time, and if it feels technical, this is a good task to hand to whoever manages your website.

Access token — access_token (required)

Think of this as a temporary permission slip that lets MokonyxSocial post to your listing. It needs the "manage your business" permission (Google calls it the https://www.googleapis.com/auth/business.manage scope). These tokens expire after about an hour, so you'll usually set things up so a fresh one can be generated when needed.

  1. Go to the Google Cloud Console at https://console.cloud.google.com and create (or pick) a project.
  2. Ask Google for access: from Google's Business Profile developer page (https://developers.google.com/my-business/content/prereqs), submit the access request form using the same Google account. You have to be approved before anything will work.
  3. Turn on the Business Profile tools: in APIs & Services → Library, enable the My Business Business Information API, Account Management API, and Business Profile Performance API.
  4. Set up the sign-in screen in APIs & Services → OAuth consent screen, and add the business.manage permission.
  5. In APIs & Services → Credentials (https://console.cloud.google.com/apis/credentials), create an OAuth client ID.
  6. Use Google's OAuth 2.0 Playground (https://developers.google.com/oauthplayground) with your client details to sign in and get an access token. Copy that token here.

Which location — account_location (optional)

If your business has just one location, you can usually leave this blank. If you manage several, this tells MokonyxSocial exactly which one to post to. It looks like accounts/12345/locations/67890.

  1. You can find the exact value using the same Google tools from the token steps (the account list and location list), or identify the right location in https://business.google.com.
  2. Paste it in the accounts/.../locations/... form. When in doubt with a single location, leave it empty.

Set it up in MokonyxSocial

  1. In Joomla admin, go to Components → MokonyxSocial → Services → New.
  2. Choose Google Business Profile.
  3. Enter the credentials from the section above.
  4. Click Send Test to verify the connection, then Save & Close and ensure the service is Published.

Verify

  • Send Test should come back successful.
  • Send a post from MokonyxSocial, then look at your business on Google Search or Maps (or at business.google.com) — your update should appear within a few minutes.

Troubleshooting

  • "Permission denied" or "insufficient scopes" — either the token is missing the business.manage permission, or Google hasn't approved your access request yet. Fix the permission and confirm your approval came through.
  • It stopped working after an hour — the access token expired. Generate a fresh one and paste it in.
  • It can't find your location — the accounts/.../locations/... value is off. Copy it exactly.
  • Errors about quota or "not found" — make sure the current Business Profile tools are switched on and your access request is approved.

Notes & limits

  • These are Google "posts/updates" on your listing (like a What's New, Offer, or Event) — not a general social feed.
  • A picture plus a short blurb works best; Google limits length and can remove posts that break its rules.
  • Google caps how often you can post, so very frequent posting may be throttled.
  • Only locations your Google account actually manages will work.