Part 1 — Create your Google Cloud project & enable the required APIs

1. Create (or choose) a Google Cloud project
   Open the “Create Project” page and give your project a name (for example, Limecube Reviews). Click Create.
   If you already have a project, you can use it. In the top bar of Google Cloud, click the project name (the drop-down next to the Google Cloud logo) to pick your project.
2. Open the API Library
   Go to the API Library homepage: console.cloud.google.com/apis/library.
   Check the top bar shows your project’s name. If it doesn’t, click the project picker and switch to your project.
3. Enable the two Google Business Profile APIs
   1. In the Library search box, type Business Information API. Click it, then click Enable.
   2. Click Back to API Library, search for My Business Account Management API, click it, then click Enable.
   Tip: If you see a Manage button instead of Enable, that API is already enabled.
4. Confirm both APIs are enabled
   Open your project’s Enabled APIs page: console.cloud.google.com/apis/enabled. You should see:
   • Business Information API
   • My Business Account Management API

Troubleshooting

• “Failed to load” or a page error appears: open the Library home link above, make sure your project is selected in the top bar, then search the API name again.
• Still stuck? Try an incognito/private window, disable ad-blockers, or clear site data for console.cloud.google.com.

Part 2  Configure OAuth (Consent Screen & Credentials)

All the points below happen from the left side bar in Google Cloud, starting from: https://console.cloud.google.com/apis/credentials/consent

1. Set up the OAuth consent screen:

https://console.cloud.google.com/apis/credentials/consent

1. Go to https://console.cloud.google.com/apis/credentials
2. Fill App name and Support email
3. User type: External (or Internal for company Workspace users only).
4. Contact Information - contact email.
5. Scopes: add https://www.googleapis.com/auth/business.manage.
6. Save (Testing mode is fine—add your Google account as a Test user).

2. Branding (configure for Production)

1. Open Branding
   1. In the left sidebar, click Branding.
2. App information (these fields should already be filled out from the previous step)
   1. App name
   2. User support email
   3. Developer contact information
3. App logo
   1. Click Upload and add a square PNG/JPG (≤ 1 MB; 120×120 px or larger).
   2. This appears on the consent screen.
4. Authorised domains (required for Production)
   1. Click Add domain and enter your website’s root domain (e.g. yourdomain.com).
   2. If Google asks you to verify ownership, complete the prompt (HTML file via Search Console or TXT record via your domain).
   3. When verification is done, return to Branding → Authorised domains, add the same domain, and Save.
5. App domain links (must use your authorised domain)
   1. Application home page: e.g. https://yourdomain.com/
   2. Application privacy policy link: e.g. https://yourdomain.com/privacy-policy/
   3. Application terms of service link: e.g. https://yourdomain.com/terms/
   4. All three URLs must live on the domain you added under Authorised domains.
6. Save
   1. Scroll to the bottom and click Save.
   2. If you see a warning about domains, add/verify the domain (Step 4) and save again.

3. Audience - Move on to Production

1. Open Audience
   1. In the left sidebar, click Audience
   2. Make sure User type = External,
   3. Then click 'Publish app', to publish to live/production (Google may ask for app verification because the Business Profile scope is sensitive).

If verification is requested, ensure the logo, authorised domain, home page, privacy policy, terms, and support email are all set as above, then follow Google’s prompts.

4. Data Access

1. Open Data Access
   1. In the left sidebar: Click Data access.
   2. Click the 'Add or remove scopes' button.
   3. In the right side panel that slides open:
      1. Under 'Manually add scopes' paste in: https://www.googleapis.com/auth/business.manage and click 'Add to table'. That will add it to the table above and have it pre-selected.
   4. Click Update

5. Create the OAuth Client ID in Google Cloud

Step A — Create the Apps Script project (to obtain your Script ID)

Open a new tab (leave the Google Cloud tab open)

1. Open script.google.com and click New project.
2. Click the project name at the top left and rename it (e.g. GBP Reviews Proxy).
3. Paste in the full “Google Reviews Proxy” code from this file: gbp-reviews.
4. Click Project settings (left sidebar, cog icon).
   • Copy the value labelled Script ID (it's a long string of characters). Keep this handy.

Step B — Create the OAuth Client ID in Google Cloud

Return back to your Google Cloud tab.

1. Open Clients
   1. Click Create client → OAuth client ID.
   2. Set Application type to Web application.
   3. Set Application type to Web application.
   4. Name: e.g. GBP Reviews – Apps Script.
   5. Leave Authorized JavaScript origins empty.
   6. Under Authorized redirect URIs, click Add URI and paste:
      https://script.google.com/macros/d/SCRIPT_ID/usercallback
      Replace SCRIPT_ID with the Script ID you copied in Step A.
   7. Click Create. Copy both values shown: Client ID and Client secret.

Step C — Link the Apps Script to the same Cloud project

1. In the Cloud Console, go to Home (Dashboard). Copy the Project number.
2. Return to Apps Script → Project settings → in Google Cloud Platform (GCP) Project click Change project.
3. Paste the Project number and click Set project.

Step D — Add your Client ID & Secret into Apps Script

1. In Apps Script, open Project settings → Script properties → Add property.
2. Add these two properties exactly (names are case-sensitive):
   OAUTH_CLIENT_ID in the first 'Property field → and paste your Client ID into the 'value field'.
   OAUTH_CLIENT_SECRET in the first 'Property field → and paste your Client secret into the 'value field'.
3. Click Save.

Step E — Deploy and authorise the web app

1. Click Deploy → New deployment.
2. Choose Web app as the deployment type (Select type → little cog icon).
3. Execute as: Me (your Google account).
4. Who has access: choose according to your Limecube integration (commonly 'Anyone').
5. Click Deploy, then click 'Authorize access' and follow the prompts. You should authorise access with the same email used to access the Google Cloud setup.
6. This completes the connection.

Troubleshooting

• If you land on a blank or “Failed to load” screen, open Auth Overview, confirm the correct project in the top bar, then navigate to Branding, Audience or Data access again.
• Use an incognito window if the console appears stuck or cached.
• Ensure the Google account you’ll use with Apps Script is added as a Test user while the app is in Testing.

Part 3 — Find Your Account ID & Location ID

The friendliest way is Google’s OAuth 2.0 Playground.

1. Open Playground
   https://developers.google.com/oauthplayground
2. Click the settings gear in the top right, and tick Use your own OAuth credentials.
   1. Paste the same Client ID & secret from Part 2. Close (these settings will save automatically).
3. Step 1: Authorise the scope
   Copy this url below:
   

   https://www.googleapis.com/auth/business.manage

   And paste into the field next to the 'Authorize APIs' button.
   Click Authorize APIs and allow the prompts.
4. Step 2: Exchange authorisation code (Playground does this automatically).
5. Step 3: Send these requests:
   • List Accounts (copy the numeric accountId):

     GET https://mybusinessbusinessinformation.googleapis.com/v1/accounts

   • List Locations for that account (copy the numeric ID from each name like locations/123...):

     GET https://mybusinessbusinessinformation.googleapis.com/v1/accounts/ACCOUNT_ID/locations?pageSize=100&readMask=name,title

You now have: Account ID and Location ID.

Part 4 — Fill the Limecube Widget Fields

Minimum Star Rating

• Show only reviews with this star rating or higher.
• Default: 4 (only show 4★+).

Maximum Number of Reviews

• The maximum number of Google reviews to load and display from your connected account.
• Default: 50.

Scroll Speed (pixels per second)

• Controls how fast the reviews scroll across the screen. Higher values scroll faster.
• Default: 60 (higher = faster).

Hover Slowdown Factor

• This makes the speed of the auto-scrolling slow down for people wanting to read a bit longer while hovering over the card.
• Default: 0.35 (35% of normal speed on hover).

Proxy Endpoint URL

• Enter the full URL of your Google Apps Script or proxy endpoint that connects to the Google Reviews API.
• Paste your Apps Script Web app URL (ends with /exec).

Google Business Account ID

• Your Google Business Profile Account ID. This identifies your GBP account for fetching reviews.
• Paste the numeric ID from the “List Accounts” response.

Google Business Location ID

• Your specific location ID from Google Business Profile where the reviews are sourced.
• Paste the numeric part of the name (e.g., from locations/6723368497723051295 paste 6723368497723051295).

Date Format

• Default: dd/MM/yyyy. Examples: dd/MM/yyyy → 12/05/2025, MMM dd, yyyy → May 12, 2025.