How to set up Google Business Profile API access and get OAuth 2 credentials
August 31, 2026
💡 Note that Google Business Profile uses the
https://www.googleapis.com/auth/business.managescope, which Google classifies asSensitive. You need to contact Unified's Support to setup a CNAME for the API URL in order to get your App approved by Google.
Check How to set up a custom API URL.
⚠️ Enabling the APIs is not enough. Until Google approves your Application for Basic API Access, your project's quota for the Business Profile APIs stays at 0 requests per minute and every call fails with a
429. Submit that form as early as possible — Google's review can take several days to a few weeks.
- Prerequisites
- A Google account with owner or manager access to the Business Profile(s) you want to connect.
- A verified, active Business Profile. Google's review expects the profile to have been active for at least 60 days and to have a website listed on it.
- Review Google's Prerequisites page before you apply.
- Create a Google Cloud project
- Go to the Google Cloud Console and sign in with that Google account.
- Click the Select a project dropdown at the top of the page and choose New Project.
- Give your project a name and click Create.
- Copy the Project number and Project ID from the Cloud Console dashboard — you need them in the next step.
- Submit the Application for Basic API Access
- Open the Application for Basic API Access form.
- Fill in the requested information:
- The Project ID and Project number from step 2
- The email address of an owner or manager of the Business Profile
- Your company name, website and a description of how you will use the API
- Submit the form. Google sends a follow-up email once the request has been reviewed.
- You do not have to wait for approval to continue — steps 4 to 8 can be completed right away.
- Enable the Business Profile APIs
- In the Google Cloud Console, make sure your project is selected.
- Navigate to APIs & Services > Library and enable each of the following:
- Google My Business API (
mybusiness.googleapis.com) — posts and reviews - My Business Account Management API (
mybusinessaccountmanagement.googleapis.com) — the accounts you manage - My Business Business Information API (
mybusinessbusinessinformation.googleapis.com) — the locations under each account - Business Profile Performance API (
businessprofileperformance.googleapis.com) — location insights
- Google My Business API (
- These four are the only APIs Unified calls. Google documents several others (Notifications, Verifications, Q&A, Place Actions, Lodging) — you do not need them for a Unified connection.
- The Google My Business API only becomes visible in the Library after your Basic API Access request is approved. If you cannot find it, come back to this step once you receive Google's approval email.
- Configure the OAuth Consent Screen
- In the Google Cloud Console, go to Google Auth Platform.
- Fill in what is asked and click Create.
- Go to Auth Branding and fill in the required information, including your app name, support email, authorized domain and privacy policy URL.
- Scopes
- Go to Auth Data Access.
- Add
https://www.googleapis.com/auth/business.manage, plusopenid,userinfo.emailanduserinfo.profile. - The exact list of scopes used by Unified can always be found in the Google Business Profile integration in the Unified App.
- Note that
business.manageis aSensitivescope, so you need to contact Unified's Support to setup a CNAME for the redirect URL in order to get your App approved by Google. - Review the information and click Save and Continue through the steps.
- Create OAuth 2.0 Credentials
- Go to Auth Clients in the Google Cloud Console.
- Click on + Create Client and select Web application.
- Configure the authorized redirect URI. Get the correct value from the Google Business Profile integration in the Unified App.
- Copy your Client ID and Client Secret.
- Publish your Application
- Go to Auth Audience and click on Publish app.
- Because you are using a
Sensitivescope, Google will require verification of your app. Until it is verified, your consent screen will show theunified.toname, which is inferred from the redirect URL — this is what the CNAME in step 1 solves.
- Configure your Unified integration
- In the Google Business Profile integration in the Unified App, enter:
- The OAuth client's Client ID
- The OAuth client's Client Secret
- Save the integration. You are now ready to authorize a Google Business Profile connection.
- In the Google Business Profile integration in the Unified App, enter:
- Verify that your API access was approved
- Go to IAM & Admin > Quotas in the Cloud Console and filter by one of the Business Profile services, for example
mybusinessaccountmanagement.googleapis.com. - A Requests per minute limit of 0 means your Basic API Access request has not been approved yet.
- A limit of 300 means you have been approved and your connection will work.
- Go to IAM & Admin > Quotas in the Cloud Console and filter by one of the Business Profile services, for example
Troubleshooting
| Symptom | Cause and fix |
|---|---|
429 RATE_LIMIT_EXCEEDED — Quota exceeded for quota metric 'Requests' and limit 'Requests per minute' | Either your Basic API Access request is still pending (quota is 0 QPM), or you are exceeding the default 300 QPM. Check the quota as described in step 10, and request a quota increase from the same Quotas page if you legitimately need more. |
invalid_client when authorizing a connection | The Client ID or Client Secret in the Unified integration does not match the OAuth client, or the redirect URI in Google does not match the one shown in the integration. Re-copy all three values. |
403 PERMISSION_DENIED or an empty list of accounts | The Google account used to authorize does not have owner or manager access to the Business Profile, or the required API from step 4 is not enabled on the project. |
The consent screen shows unified.to instead of your app name | Your app has not been verified by Google yet. Contact Unified's Support to setup a CNAME for the API URL, then submit your app for verification. See How to set up a custom API URL. |
| An API cannot be found in the Cloud Console Library | The Google My Business API is only exposed once Google approves your Basic API Access request. Wait for the approval email and enable it then. |