Set up a Google Calendar data store

Note: You must enable Google Workspace smart features in other Google products to connect Google Calendar data to Gemini Enterprise. For information, see Turn Google Workspace smart features on or off.

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

Before you begin

• Sign in to the Google Cloud console with the same account that you use for the Google Workspace instance that you plan to connect. Vertex AI Search uses your Google Workspace customer ID to connect to Google Calendar.

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

• Before you add actions to the Google Calendar data store, a Google Cloud administrator must first complete the steps in the Set up authentication and permissions for Google Calendar section to configure OAuth 2.0 authentication to provide you with the client ID and client secret and to set up scopes.

Create the Google Calendar data store

To create the Google Calendar data store, perform the following steps:

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. In the Source, search for Google Calendar, and click Select.

6. In the Actions section:

   1. Enter the Client ID and Client Secret obtained from the OAuth 2.0 application, and then click Verify Auth.

      For more information, see Create OAuth client credentials. For the scopes required for search and actions, see Required scopes.

   2. Optional: Expand Advanced settings and enter the Service name, the resource name of your service created in Service Directory within your Google Cloud project. This field is required when VPC Service Controls is enabled.

   3. Choose the actions from the list to enable them for Google Calendar connector.

   Note: If you skip adding actions in this step, you must create a new data store to add actions.

   To view the list of actions, see View actions.

7. Click Continue.

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

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

11. Click Create. Gemini Enterprise creates your data store and displays your data stores on the Data Stores page.

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

After creating the data store, create an app and connect it to the Google Calendar data store before executing the query.

Query execution

After you authorize Google Calendar, when you enter a search query:

1. Gemini Enterprise sends your search query to the Google Calendar API.

2. Gemini Enterprise blends the results with those from other sources and displays them.

Error messages and troubleshooting

The following table describes error messages, including HTTP error codes and suggested troubleshooting steps, that you might encounter when working with this Google data source.

Error code	Error message	Description	Troubleshooting
403 Permission Denied	Searching using service account credentials isn't supported for Google Workspace data stores.	The engine being searched has Google Workspace data stores, and the credentials passed are of a service account. Searching using service account credentials on Google Workspace data stores isn't supported.	Call search using user credentials, or remove Google Workspace data stores from the engine.
403 Permission Denied	Consumer accounts aren't supported for Google Workspace data stores.	Search is called using a consumer account (@gmail.com) credential, which isn't supported for Google Workspace data stores.	Remove Google Workspace data stores from the engine or use a managed Google Account.
403 Permission Denied	Customer id mismatch for data store	Search is only allowed for users who belong to same organization as Google Workspace data stores.	Remove Google Workspace data stores from the engine or contact support if the user and Google Workspace data stores are meant to be in different organizations.
403 Permission Denied	Workspace access for Agentspace disabled by organization administrator.	A Google Workspace administrator has disabled access to Google Workspace data for Gemini Enterprise.	Contact your Google Workspace administrator to [enable access](https://support.google.com/a/answer/16479199).

What's next

• To provide a user interface for querying your Google Calendar data, create an app and connect it to the Google Calendar data store.
• To view the list of actions you enabled for the Google Calendar data store, see View 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.