Step 1: Account Setup

Before installing the Google Business Profile Connector app, you’ll need to ensure your GBP data is properly structured and connect your GBP account to Yext.

Data Preparation

Ensure that you have Owner access in GBP, ensure your store codes are set up to map properly to Yext, and configure the Photo Gallery field to sync photos to entities.

Confirm Owner Access

To install the connector app, you will need Owner level access in your GBP account. If you do not have Owner access in GBP, please reach out to the administrator of your organization’s GBP account.

To make sure the correct photos are imported to Yext for your locations, configure the Photo Gallery field in Yext as shown below:

google sync settings

Visit the Manage Publisher Configurations help article for steps to configure this setting.

Existing Yext Data: Match Entity IDs to Store Codes

If you already have entities created in the Yext Knowledge Graph that you would like to enrich with data from your Google Business Profile account, make sure that the Entity IDs of the entities in Yext match the locations’ Store Codes in Google Business Profile. If these do not match, the connector will create new locations in Yext (instead of updating existing ones), or could add data to the wrong locations.

If you do not yet have entities created in the Knowledge Graph, you can skip this step. You’ll map your GBP store codes to your new entities in the Knowledge Graph later in the guide.

The Google Business Profile connector app uses OAuth to access your Google data. To provide access, you must link your GBP account with Yext.

  1. Navigate to Linked Accounts in Yext and click +Add Linked Account next to Google.
  2. Check off https://www.googleapis.com/auth/business.manage as your scope. If you wish to use the same account to pull data from Google Drive as well as GBP, you can check off that scope as well. Be aware, however, that if you are using a Reseller account, whichever OAuth scope you enable will be available for all sub-accounts.
  3. Click Link.
  4. In the popup, choose the Google account you’d like to link to.
    • Note: you must have previously logged into this Google account on the device you’re using in order for it to appear. If the account doesn’t appear, log into it in a separate window, and then return to this page and refresh.
  5. Go through the authorization flow. When prompted to provide a name for your linked account, an editable ID will be automatically populated. Note this ID as you will need it in the app installation flow.
  6. Click Save.