Google My Business

The Google My Business modules enable you to monitor, create, update, retrieve, or delete posts, reviews, and search locations in your Google My Business.

Getting Started with Google My Business

Prerequisites

In order to use Google My Business with Make, it is necessary to have a Google account. If you do not have one, you can create a Google account at www.google.com/accounts/NewAccount.

Notice

The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!

Connecting Google My Business to Make

To connect your Google My Business account to Make you need to obtain the project's Client ID and Client Secret in the Google API Console.

1. Sign in to Google Cloud Platform using your Google credentials.

2. Click the CREATE PROJECT button.

61d5b515d55f8.gif

3. Enter the desired project name and click the CREATE button.

61d5b51859607.gif

4. Complete and submit the access request form.

Note

To retrieve your Project ID and Project number open the Dashboard page in your console and select your Google My Business project.

7wy2zflaj3.gif

A follow-up email is sent to you after your request has been reviewed.

5. Go to the Basic Setup page and click the Enable Google My Business API button.

61d5b51aa6d74.png

6. Go to APIs & Services > Credentials. Click on the CREATE CREDENTIALS button and select the OAuth client ID option from the menu.

61d5b51c4ddd6.gif

7. Fill in the required fields as follows and then click the CREATE button to create the application:

Application type

Web application

Name

e.g. Make

Authorized redirect URIs

https://www.integromat.com/oauth/cb/google-custom

8. A dialog containing the app's Client ID and Client Secret is displayed. Save them to a safe place for later use.

61d5b51ed0d82.png

9. Go to Make, open the Create a connection dialog of the desired Google My Business module, enter the Client ID and Client Secret from step 8 above to the respective fields, and click Continue.

10. Sign in with your Google account.

20. Click the Allow button to grant Make access to your Google My Business.

61d5b51fe09c1.png

The connection to your Google My Business account has been established.

Post

Returns post details when a post is added or updated on the specified location.

Connection

Establish a connection to your Google account.

Watch posts

Select whether you want to watch created posts (By creation time) or updated posts (By update time).

Location name

Select the business location you want to watch for new or updated posts.

Limit

Set the maximum number of posts Make will return during one execution cycle.

Retrieves a list of local posts associated with a location.

Connection

Establish a connection to your Google account.

Location name

Enter (as a URL path, accounts/{accountID}/locations/{locationID}) or select the location you want to retrieve posts from.

Limit

Set the maximum number of posts Make will return during one execution cycle.

Retrieves post details.

Connection

Establish a connection to your Google account.

Location name

Select the location that contains the post you want to retrieve details about.

Post name

Enter (as a URL path, accounts/{accountID}/locations/{locationID}/localPosts/{postID}) or select the post you want to retrieve details for.

Creates a new local post associated with the specified location.

Connection

Establish a connection to your Google account.

Location name

Enter (as a URL path, accounts/{accountID}/locations/{locationID}) or select the location you want to create a post at.

Title

Enter the name of the event/offer.

Summary

Enter the description (body) of the local post.

Post Type

  • Event - Promote an event at your business. Events require a title, start and end dates, and time. If there aren’t start or end times, then the system will default to 24 hours on the date it's posted. These posts may also include a photo, video, description.

  • Call to Action - An action that is performed when the user clicks through the post.

  • Offer - Provide promotional sales or offers from your business. Offers require a title, start/end dates and times. A "View offer" action button is automatically added to the post. You can also include a photo, video, description, coupon code, link, and terms and conditions with the post.

  • Alert (COVID19) - Alerts related to the 2019 Coronavirus Disease pandemic. Covid posts only support a summary field and a call to action field. When these alerts are no longer relevant, new Alert post creation for type COVID-19 will be disabled. However, merchant will still be able to manage their existing COVID-19 posts.

Start date

Enter the start time and date of the event or offer. The list of supported date and time formats.

End date

Enter the end time and date of the event or offer. The list of supported date and time formats.

Action Type

Select an action that is performed when the user clicks through the post.

  • Book: Creates a Post that prompts a user to book an appointment, table, or something similar.

  • Order: Creates a Post that prompts a user to order something.

  • Shop: Creates a Post that prompts a user to browse a product catalog.

  • Learn more: Creates a Post that prompts a user to see additional details on a website.

  • Sign up: Creates a Post that prompts a user to register, sign up, or join something.

  • Call: Creates a Post that prompts a user to call a business.

URL

Enter the URL the user will be directed to upon clicking.

Coupon code

Enter the offer code that is usable in store or online.

Redeem Online URL

Enter the online link to redeem offer.

Terms & Conditions

Enter offer terms and conditions.

Add time

Enable this option to specify the start and end time/date for the offer. The list of supported date and time formats.

Media Items

Add photos and/or video to the post.

Language

Enter the language of the local post.

Updates an existing local post.

Connection

Establish a connection to your Google account.

Get a Post

Select whether to specify the post manually or select from the drop-down menu.

Post name

Enter the path to the post in the following format: /accounts/{accountID}/locations/{locationID}/localPosts/{postID} or select the post you want to update.

Please find the descriptions of the fields in the Create a Post section above.

Deletes a post.

Connection

Establish a connection to your Google account.

Get a Post

Select whether to specify the post manually or select from the drop-down menu.

Post name

Enter the path to the post in the following format: /accounts/{accountID}/locations/{locationID}/localPosts/{postID} or select the post you want to delete.

Review

Retrieves review details when a review is created or updated.

Connection

Establish a connection to your Google account.

Watch reviews

Select whether you want to watch created reviews (By creation time) or updated posts (By update time).

Location name

Select the business location you want to watch for new or updated posts.

Limit

Set the maximum number of reviews Make will return during one execution cycle.

Updates the reply to the specified review. A reply is created if one does not exist.

Note

This operation is only valid if the specified location is verified.

Connection

Establish a connection to your Google account.

Enter a review name

Select whether to specify the review manually or select from the drop-down menu.

Review name

Enter the path to the review in the following format: /accounts/{accountID}/locations/{locationID}/reviews/{reviewID} or select the review you want to create or update.

Reply comment

Enter the body of the reply as plain text with markups. The maximum length is 4096 bytes.

Location

Searches for the locations by the filter settings.

Connection

Establish a connection to your Google account.

Filter search

Select the filter field you want to specify the search term for.

Location name

The business' real world name.

Primary phone

The primary phone number in E.164 format (For example "+441234567890").

Address region code

The CLDR region code of the country/region of the address. E.g. US

Address administrative area

The highest administrative subdivision which is used for postal addresses of a country or region. E.g. CA

Address locality

The city/town portion of the address. E.g. New York

Address postal code

The postal code of the address.

Open info status

Indicates whether or not the Location is currently open for business. Possible values: OPEN, CLOSED_PERMANENTLY

Location state is published

Indicates whether the location is published to Google Maps. Possible values: TRUE, FALSE

Location key place ID

If this location has been verified and is connected to/appears on Google Maps, this field is equal to the place ID for the location

Order by

Select whether to order the result by location name or store code

Descending order

Enable this option to sort results in the descending order.

Language Code

Enter the language code to filter results by.

If the specified language is not available, results will be returned in the language of the location. If neither is available, it will be returned in English.

Limit

Set the maximum number of locations Make will return during one execution cycle.

Retrieves details of the specified location.

Connection

Establish a connection to your Google account.

Location name

Enter the path to the location in the following format: /accounts/{accountID}/locations/{locationID} or select the location you want to retrieve details about.

Uploads a new media item on the specified location.

Connection

Establish a connection to your Google account.

Location name

Enter the path to the location in the following format: /accounts/{accountID}/locations/{locationID} or select the location you want to upload a media to.

URL address of media item

Enter a publicly accessible URL where the media item can be retrieved from.

Media format

Select the format of the media item.

Category

Select the media item category.

Cover

Cover photo. A location has only one cover photo.

Profile

Profile photo. A location has only one profile photo.

Logo

Logo photo.

Exterior

Exterior media.

Interior

Interior media.

Product

Product media.

At work

'At-work' media.

Food and drink

Food and drink media.

Menu

Menu media.

Common area

Common area media.

Rooms

Rooms media.

Teams

Teams media.

Additional

Additional, uncategorized media.

Accepts or decline the specified invitation.

Connection

Establish a connection to your Google account.

Invitation name

Enter the path to the invitation in the following format: /accounts/{accountID}/invitation/{invitationID} or select the invitation you want to accept or decline.

Select

Select whether to accept or decline the invitation.

Other

Allows you to perform a custom API call.

Connection

Establish a connection to your Google account.

URL

Enter a path relative to https://mybusiness.googleapis.com/. For example: /v4/accounts.

Note

For the list of available endpoints, refer to the Google My Business API Documentation.

Method

Select the HTTP method you want to use:

GET to retrieve information for an entry.

POST to create a new entry.

PUT to update/replace an existing entry.

PATCH to make a partial entry update.

DELETE to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

The following API call returns all reviews of the specified location in your Google My Business account:

URL: /v4/accounts/{accountID}/locations/{locationID}/reviews/

Method: GET

61d5b5211a28f.png

The result can be found in the module's Output under Bundle > Body > reviews. In our example, 3 reviews were returned:

61d5b52254c91.png