Step 1: Create a Google Business Profile Source Connector to Import Data

Overview

The Google Business Profile Connector source has three operations to choose from: Fetch Locations, Fetch Locations with Filters, and Fetch Hotels. Each of these operations are detailed below.

Note: If you have existing location data in your Yext account that you would like to enrich with data from your Google Business Profile account, make sure that the Entity IDs of your locations in your Yext account match the Store Codes in your Google Business Profile account. If this is not the case you will create new locations in your Yext account or add data to the wrong locations.

Create the Connector

  1. Navigate to Content > Connectors and click + Add Connector in the top right corner.
  2. Click the Google Business Profile source and select the preferred operation.
    • Fetch Locations — this will pull in all locations from the linked Google account.
    • Fetch Locations with Filters — this option allows you to import a subset of the locations in one of your Google Business Profile location groups.
    • Fetch Hotels — this operation is specifically for Hotel entities, as Google has a separate Lodging endpoint that pulls in location information specifically for hotels and hotel-specific information.
  3. Select your Linked Account. If you have yet to link your account, you can click Add a Linked Account. You will then be redirected to the Linked Accounts page, where you can follow the flow to add a Google Linked Account. Be sure to check off https://www.googleapis.com/auth/business.manage as your scope, and return to the connector flow after linking the account.
  4. In the Location Group field input the ID associated with the Location Group from which you wish to pull entity information. You can find this in the URL in Business Profile when you are viewing your location group, e.g., https://mybusinessbusinessinformation.googleapis.com/v1/{location-group-ID}/locations.
  5. (Only for Fetch Locations With Filters Operation) In the Filter field input the field you would like to filter on. You can use Google Business Profile’s API documentation on filtering to learn what syntax is expected (e.g., representing spaces with + and quotation marks with %22).
  6. Click Continue.
  7. Now you’ll choose which selectors from Google’s API response to pull information from. We recommend clicking Add Default Selectors to quickly see all the available information, however, you can also individually add selectors if you only need to import a few fields.
    • You can now add whatever transforms you’d like, if your data is not formatted properly. When you’re finished, click Continue.
  8. In the final step, choose the Entity Type you’d like to bring in, and map the selectors you specified to Yext fields. Click Save, name the connector and run it either now or later!