Note: This documentation applies to the Standard, Plus, and Frontline editions of Gemini Enterprise. For information about the Business edition, see the Gemini Enterprise - Business edition Help Center .

Set up a Shopify data store

This page describes how to create a data store and connect Shopify to Gemini Enterprise.

Before you begin

Before setting up your Shopify connection, ensure you have the following in place:

Grant the Discovery Engine Editor role ( roles/discoveryengine.editor ). This role is required for the user to create the data store. To grant this role, do the following:
1. In the Google Cloud console, go to the IAMpage.
  Go to IAM
2. Locate the user account and click the edit Editicon.
3. Grant the Discovery Engine Editor role to the user. For more information, see IAM roles and permissions .

Create Shopify data store

To create a Shopify data store, perform the following steps:

In the Google Cloud console, go to the Gemini Enterprise page.

Gemini Enterprise
Select or create a Google Cloud project.
In the navigation menu, click Data stores.
Click Create data store.
In the Sourcesection, search for Shopify, and click Select.
In the Datasection:
1. In the Authentication settingssection, enter the following details:
  - Client ID: The identifier for your OAuth 2.0 app.
  - Client secret: The secret key associated with your OAuth 2.0 app.
  - Store URL: The Shopify store URL. For example, https://abc-123.myshopify.com .
  For more information about credentials, see Shopify configuration .
2. In the Destinationssection, do the following:
  1. In the Shop URLfield, enter the Shopify store URL. For example, https://abc-123.myshopify.com .
  2. Click Continue.
3. In the Entities to searchsection, select all the required entities.
Click Continue.
In the Configurationsection:
1. From the Multi-regionlist, select the location for your data connector.
2. In the Your data connector namefield, enter a name for your connector.
3. If you selected us or eu as the location, configure the Encryption settings:
  - Optional: If you haven't configured single-region keys, click Go to settings pageto do so. For more information, see Register a single-region key for third-party connectors .
  - Select Google-managed encryption keyor Cloud KMS key.
  - If you selected Cloud KMS key:
    - In the Key management typelist, select the appropriate type.
    - In the Cloud KMS keylist, select the key.
  For more information, see Customer-managed encryption keys .
Click Continue.
In the Billingsection, select General pricingor Configurable pricing. For more information, see Verify the billing status of your projects and Licenses .
Click Create. Gemini Enterprise creates your data store and displays your data stores on the Data Storespage.

On the Data Storespage, click your data store name to see the status. After the data store state changes from Creatingto Active, the Shopify connector is ready to be used.

After creating the data store, connect the data store you just created to an existing app or create a new app and connect it to the new app, and authorize Gemini Enterprise to access Shopify before executing any queries. To know more, see What's next .

Data handling and query execution

This section describes how Gemini Enterprise manages your query and the privacy implications of using the federated data store.

Query execution

After you authorize Shopify and send a search query to Gemini Enterprise:

Gemini Enterprise sends your search query directly to the Shopify API.
Gemini Enterprise blends the results with those from other connected data sources and displays a comprehensive search result.

Data handling

When using third-party federated search, the following data handling rules apply:

Your query string is sent to the third-party search backend (Shopify API).
These third parties may associate queries with your identity.
If multiple federated search data sources are enabled, the query might be sent to all of them.
After the data reaches the third-party system, it is governed by that system's terms of service and privacy policies.

What's next

To provide a user interface for querying your Shopify data, create an app and connect it to the Shopify data store .
To preview how your search results appear after your app is set up, see Get search results .
To enable alerts for the data store, see Configure alerts for third-party data stores .