Set up a Dropbox data store

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

Note: To enforce data source access control and secure data in Gemini Enterprise, ensure that you have configured your identity provider.

Before you begin

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

1. 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 IAM page.

      Go to IAM

   2. Locate the user account and click the edit Edit icon.
   3. Grant the Discovery Engine Editor role to the user. For more information, see IAM roles and permissions.

2. Create an app in the Dropbox App Console. For more information, see Dropbox configuration.

Create the Dropbox data store

To create a Dropbox data store, do the following:

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

   Gemini Enterprise

2. Select or create a Google Cloud project.

   Note: To access the unified flow, your project must be on the allowlist.

3. In the navigation menu, click Data stores.

4. Click Create data store.

5. On the Select a data source page, enter Dropbox into the search field. The Dropbox card displays.

6. Click Select.

   

7. In the Data section, fill in the following fields:

   1. For the Connector mode field, select Federated search and 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 search section, select the entity types that you want Gemini Enterprise to search.

      

      Click Continue.

8. In the Actions section, 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.

9. In the Configuration section:

   1. From the Multi-region list, select the location for your data connector.
   2. In the Data connector name field, 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 page to do so. For more information, see Register a single-region key for third-party connectors.
      • Select Google-managed encryption key or Cloud KMS key.
      • If you selected Cloud KMS key:
        • In the Key management type list, select the appropriate type.
        • In the Cloud KMS key list, select the key.
      For more information, see Customer-managed encryption keys.

   

   Click Continue.

10. In the Billing section, select General pricing or Configurable pricing. For more information, see Verify the billing status of your projects and Licenses.

    

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

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

1. Create an app.

2. Connect the app to the Dropbox data store.

3. 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.

Note: To improve accuracy, an LLM may rewrite your query before it is sent to Dropbox. This rewritten query can incorporate information from your session's query history. As a result, parts of your query history might also be included in the query sent to the Dropbox API.

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.