Set up a Dropbox data store Stay organized with collections Save and categorize content based on your preferences.

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:

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 edit Edit.
   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, 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:

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

   Gemini Enterprise

2. Select or create a Google Cloud project.

3. In the navigation menu, click Data stores.

4. Click add Create data store.

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

6. Click Select.

   [Select the Dropbox data source]

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

   1. For the Connector mode field, select Federated search and click Continue.

   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.

      [Provide your client ID and client secret]

      Click Login.

   3. Click Continue.

   4. In the Entities to search section, select the entity types that you want Gemini Enterprise to search.

      [Select entities to include in 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.

   [Select actions to enable for the connector]

   Note: If you skip adding actions in this step, you can add them later. For more information, see Add actions.

   To view and manage the list of actions, see View and manage actions.

9. If the create data store flow shows an Advanced options section, you can select the Enable Static IP Addresses checkbox within it. This ensures the data store uses a fixed set of IP addresses for outbound traffic, suitable for allowlisting on the source system. For more information, see Configure static IP egress.

10. In the Configuration section:

    1. From the Multi-region list, select the location for your data connector.
    2. In the Your 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.

    [Select a location and enter a name for the data store]

    Click Continue.

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

    [Select a pricing model]

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.
• 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 data, create an app and connect it to the Dropbox data store.

• To view and manage the list of actions, see View and manage actions.

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