Intro
Business Profile allows you to create and verify your local business on Google, so your business information can be shown in Google Maps. Every day, millions of people search on Google for businesses. Make your Business Profile on Google stand out for free and turn those searches into your customers with the Google My Business app.
With Domo’s Google My Business Connector, you can easily monitor the key metrics contributing your business profile on Google. Use this Connector to monitor and yield details about your business profile with respect to clicks, navigation search, calls, views, and pings and convert those searches into customers. To learn more about the Google My Business API, visit their page (https://developers.google.com/my-business/reference/rest).
The Google My Business Connector is a "Cloud App" Connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the Connector page for this and other Cloud App Connectors by clicking Cloud App in the toolbar at the top of the window.
You connect to your Google My Business account in the Data Center. This topic discusses the fields and menus that are specific to the Google My Business Connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.
Prerequisites
To connect to your Google My Business account and create a DataSet, you must have your client ID and client secret associated with your client application.
You need your Google account in order to create a project in the Google API Console.
Create a project in the Google API Console
Before you can send requests to the Business Profile APIs, you need to use the Google API Console to create a project, and then request access to the Business Profile APIs for that project.
To create a new project:
- Go to the Google API Console.
- Click Create Project.
- Enter a project name and location, and click Create.
Request access to the APIs
To enable your project and access the APIs, you must complete the following steps:
- Go to the Google API Console and select the project you created for use with Business Profile.
- To determine your project ID, check the Project ID column.
- Complete and submit the access request form.
- A follow-up email will be sent to you after your request has been reviewed.
- After approval, enable the Business Profile APIs for your project.
There are eight APIs associated with Business Profile that must be enabled in the Google API Console:
- Google My Business API
- My Business Account Management API
- My Business Lodging API
- My Business Place Actions API
- My Business Notifications API
- My Business Verifications API
- My Business Business Information API
- My Business Q&A API
Enabling Business Profile APIs
To enable an API for your project, do the following:
- Open the API Library in the Google API Console. If prompted, select a project or create a new one. The API Library lists all available APIs, grouped by product family and popularity.
- If the API you want to enable isn't visible in the list, use search to find it.
- Select the API you want to enable, then click the Enable button.
- If prompted, enable billing.
- If prompted, accept the API's Terms of Service.
Getting your Client ID and Client Secret
1. Go to the "Credentials" section of the Google API Console.
2. Click Create credentials > OAuth client ID.
3. Select the application type and provide the name
4. Enter the following URI in the Authorized redirect URI field: https://oauth.domo.com/api/data/v1/oauth/providers/google-my-business-oauth/exchange
5. Click Create.
6. Your client ID and client secret will appear.
7. Copy these client ID and client secret and paste them into the Credentials pane of the Connector, respectively.
Connecting to Your Google My Business Account
This section enumerates the options in the Credentials and Details panes in the Google My Business Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.
Credentials Pane
This pane contains fields for entering credentials to connect to you Google My Business account. The following table describes what is needed for each field:
Field |
Description |
---|---|
Client ID | Enter your client ID associated with your client application. For more details, see "Prerequisites." |
Client Secret | Enter your client secret associated with your client application. For more details, see "Prerequisites." |
Once you have entered valid credentials, you can use the same account any time you go to create a new Google My Business DataSet. You can manage Connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.
Details Pane
This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.
Menu |
Description |
||||||
---|---|---|---|---|---|---|---|
Report |
Select the Google My Business report you want to run. The following reports are available:
|
||||||
Accounts | Select the account that you would like to include in your dataset. | ||||||
Locations | Select the location that you would like to include in your dataset. | ||||||
Sublist To Be Flattened | Select the field to be flattened in your dataset. |
Other Panes
For information about the remaining sections of the Connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.
FAQs
What version of the Google My Business API does this Connector use?
This Connector uses version 4 of the Google My Business API (https://mybusiness.googleapis.com/v4).
For the Accounts report, it uses version 1 of the Google Account Management API (https://mybusinessaccountmanagement.googleapis.com/v1).
Which endpoint(s) does each report call in this Connector?
Report Name | Endpoint URL(s) | |
---|---|---|
Accounts | /accounts | |
Locations | /accounts/{account_name}/locations | |
Reviews | /accounts/{account_name}/locations/{location_name}/reviews |
What kind of credentials do I need to power up this Connector?
You need your client ID and client secret associated with your client application. See "Prerequisites", for more information.
Are there any API limits I should be aware of?
No
Troubleshooting
- Make sure your authentication remains valid.
- Review the configuration to make sure that all required items have been selected.
- Review the Connector history for error messages.
- In rare cases, you may be requesting too much information and reaching API limitations or timeouts. If this is the case, you can review the history of the Connector run to see the error message and duration. If this is the case, you can reduce the number of accounts that are being pulled, choose a smaller number of metrics for the report that you are pulling, or reduce the timeframe that you are trying to pull.
Comments
0 comments
Please sign in to leave a comment.