Set up a Dropbox data store

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

Before you begin

Before you set up your Dropbox data store, do the following:

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 an app in the Dropbox App Console, obtain the authentication credentials, and set the required scopes. For more information, see Dropbox configuration .

Create the Dropbox data store

To create a Dropbox data store, do the following:

In the Google Google Cloud console, go to the Gemini Enterprisepage.

Gemini Enterprise
Select or create a Google Cloud project.

Note: To access the unified flow, your project must be on the allowlist.
In the navigation menu, click Data stores.
Click Create data store.
On the Select a data sourcepage, enter Dropbox into the search field. The Dropbox card displays.
Click Select.
In the Datasection, fill in the following fields:
1. For the Connector modefield, select Federated searchand click Continue.
  
  Public preview: The federated search and actions features are in public preview. This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms . Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions .
2. Under Authentication settings, enter the values you copied when you created an app in the Dropbox App Console:
  - For Client ID, enter the Dropbox app's App key.
  - For Client Secret, enter the Dropbox app's App secret.
  For more information about creating an app in the Dropbox App Console, see Dropbox configuration .
  
  Click Login.
3. Click Continue.
4. In the Entities to searchsection, select the entity types that you want Gemini Enterprise to search.
  
  Click Continue.
In the Actionssection, select the actions that you want users to be able to perform in their Dropbox accounts using the Gemini Enterprise assistant.

Note: You can't enable or add new actions for this data store after it's created.
In the Configurationsection:
1. From the Multi-regionlist, select the location for your data connector.
2. In the 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 .

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

After creating the data store, do the following before running any queries:

Create an app .
Connect the app to the Dropbox data store.
Authorize Gemini Enterprise to connect to Dropbox.

For information about the permissions required to perform a search, see Minimum permissions .

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 Dropbox and send a search query to Gemini Enterprise:

Gemini Enterprise sends your search query directly to the Dropbox 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 (Dropbox 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.
Once 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 data, create an app and connect it to the Dropbox 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 .