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

A Google account
A project created in the Google API console
Approved request form

In order to use Google My Business with Integromat, 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.

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

Connecting Google My Business to Integromat

To connect your Google My Business account to Integromat 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.

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

4. Complete and submit the access request form.

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

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.

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

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. `Integromat`
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.

9. Go to Integromat, 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 Integromat access to your Google My Business.

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

Post

Watch Posts

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 Integromat will return during one execution cycle.

List Posts

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 Integromat will return during one execution cycle.

Get a Post

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.

Create a Post

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.

Update a 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.

Delete a Post

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

Watch Reviews

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 Integromat will return during one execution cycle.

Create/Update a Review Reply

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

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

Search Locations

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 Integromat will return during one execution cycle.

Get a Location

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.

Upload a Media Item

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.

Accept/Decline an Invitation

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.

Make an API Call

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`. 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.